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PREFACE 


This manual describes operating system features intended for use 
by system programmers, system analysts, designers, engineers and 
training instructors. 


Chapter 1 presents an overview of the operating system and the 
software subsystems it supports. Chapter 2 describes the 
privileged task types supported by OS/32. Chapter 3 describes 
the techniques used in writing system level control programs that 
take advantage of the increased throughput offered by a 
Perkin-Elmer Model 3200MPS System. Chapter 4 contains a 
functional description of the supervisor call (SVC) interception 
feature. The vertical forms control (VFC) feature is described 
in Chapter 5, along - with other device-independent and 
device-dependent features supported by OS/32. 


Revision 03 is intended for use with the OS/32 R0O7.2 software 
release or higher. It introduces a change in the method of task 
execution by the auxiliary processing units (APUs) within the 
Model 3200MPS System. Therefore, Chapter 3 has been totally 
reorganized. Material related to 0OS/32 SVCs is no_ longer 
included in this manual. This material is now documented in the 
OS/32 Supervisor Call (SVC) Reference Manual. 


For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
0S/32 SUBSYSTEMS 


1.1 INTRODUCTION 


Perkin-Elmer 0S/32 is a general-purpose, event-driven operating 
system for Perkin-Elmer 32-bit computer systems. Custom versions 
of OS/32 are created through the use of a system generation 
program (Sysgen/32) that provides parameters for tailoring 0S/32 
to a specific installation. The combined hardware and software 
capabilities of a Perkin-Elmer 32-bit computer system provide 
support for all phases of program and system development. 0S/32 
supports concurrent multiprogramming, with up to 252 user 
programs written in any of the supported languages. The program 
development facilities are designed to minimize the time and 
effort needed to test, debug and integrate application programs 
and systems. In addition, the 0OS/32 command language allows 
complex jobs to be performed with minimum operator intervention. 


0S/32 incorporates a powerful interrupt handling capability at 
the task level. This capability permits a task to be interrupted 
during its normal execution sequence by a variety of hardware and 
software conditions. 


The OS/32 virtual task manager (VTM) allows the memory 
requirements of a task running under OS/32 to exceed available 
task memory. 


The roll function allows segments of a task to be rolled out to 
disk until enough memory is available for the entire task. In 
real-time applications, rolling is commonly used to queue’ low 
priority tasks while tasks of higher priority are active. The 
roll eligibility of a task is established when the task is link- 
edited. However, a task option is provided to prevent rolling of 
a task when necessary (e.g., when the task must be able to 
respond to real-time events). 


VTM has a virtual memory capability that allows tasks consisting 
of up to 16Mb of code and data to execute in as little as 128kb 
of memory. This feature is provided by the 0S/32 linkage editor. 
See the OS/32 Link Reference Manual for more information. 


A basic data communications facilities package is supplied with 
0S/32. This package also provides support for higher level 
Perkin-Elmer data communications products. 


The scope and power of the operating system can be extended 
through the following Perkin-Elmer O0S/32 companion products. 
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@® Multi-terminal monitor (MTM) 


e Reliance 


MIM is a subsystem monitor that uses the subtasking capabilities 
of OS /32 to provide a time-sliced, interactive program 
development environment for up to 64 concurrent terminal users. 
MIM simultaneously supports both on-line terminal users and batch 
background tasks. MIM terminal users are also provided with an 
input/output (1/0) spooler for use with slow speed devices. 


Reliance is a transaction software system, consisting of the 
integrated transaction controller (ITC), data management system 
(DMS/32), and industry standard COBOL. ITC allocates system 
resources, develops screen formats, and controls terminals. 
DMS/32 supervises disk allocation and data access. 


1.1.1 OS/32 Multiprocessing Support 


0S/32 provides a transparent multiprocessing capability for use 
with the Perkin-Elmer Model 3200MPS System. This system consists 
of one central processing unit (CPU) and from one to nine 
auxiliary processing units (APUs) (see Figure 1-1). A task can 
execute on an APU without any special preparation, unless it is 
going to take advantage of certain features specific to the 
multiprocessing system (e.g., APU assignment, APU control, etc.). 
See the 0OS/32 Supervisor Call (SVC) Reference Manual for more 
information. 


0S/32 defines a set of logical processing units (LPUs) that are 
used to schedule tasks to APU queues for execution on an APU. 
Tasks are assigned to an LPU that is mapped to an APU queue. The 
logical processor mapping table (LPMT) defined by O0S/32 contains 
the mapping arrangement between the LPUs and APU execution 
queues. (More than one LPU can be mapped to an APU queue.) 


Each APU in a Model 3200MPS System is assigned a_ unique 
identifying number and is assigned to an APU queue. (More than 
one APU can be assigned to a queue.) Tasks on the APU queue 
execute on an APU assigned to the queue. 


If a task is mainly computation intensive, executing that task on 
an APU increases overall system performance. An I/0O-intensive 
task, if directed to an APU, decreases system performance since 
each I/O request requires the task to be transferred back to the 
CPU for OS/32 I/O support services. 


The main performance advantage of a multiprocessing system is 
achieved when a problem is broken down into parts so that several 
tasks on several processors can work on the problem at the same 
time. See Chapter 3 for more information on programming within 
a Perkin-Elmer Model 3200MPS System environment. 
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Figure 1-1 Typical Model 3200MPS System Configuration 


1.2 SOFTWARE SUBSYSTEMS 


0S/32 consists of the following subsystems: 


Task management 

Job accounting 

Memory management 

Timer management 

File management 

I/O management 

Error recording and reporting 
Memory diagnostics 

Loader and segmentation 

Basic communications 

Console monitor 

Command processor 

System initialization 
Internal interrupt | 

Optional user supervisor call 14 (SVvC14) 
Floating point 


Table 1-1 summarizes the software supported by 0OS/32. 
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TABLE 1-1 PERKIN-ELMER OS/32 SOFTWARE SUPPORT 


TYPE H SOFTWARE PRODUCT |} STANDARD {| OPTIONAL 
Program {| Task management | 
develop- {| Job accounting H 
ment | Memory management | 

} Timer management | 
| File management | 
| I/O management H 
{| Error recording and reporting | 
i Memory diagnostics | 
{ Loader and segmentation i 
| Console monitor | 
;} Command processor } 
| Floating point H 
{ Internal interrupt subsystem H 
; ITc* H 
{ Writable control store (WCS) { 
i | 
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| Program {| Automatic interactive debugging H H 
} debugging | system (AIDS) i x { 
| | DEBUG/32 \ ' 


| Data base } 
} manage- i 
} ment { 
i 


{| Asynchronous data communications | 
| Character synchronous communica-_ | 
cations ;} tions H 
} Bit synchronous communications { 
' 2780/3780 RJE emulation H 
{ 3270 emulation i 
| HASP/32 | 
} Ethernet communications H 
Languages {| Common microcode assembler 

i (MICROCAL) 

} Common assembly language/32 

| (CAL/32) 

| CAL macro/32 

} FORTRAN VII development (D) 

i compiler 

{ FORTRAN VII global optimizing (0) 

| compiler 
} FORTRAN VII universal optimizing 
| (2) compiler 
| COBOL* 
i BASIC Level II 
| CORAL 66 
i RPG II 
| PASCAL 


tad 
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TABLE 1-1 PERKIN-ELMER O0S/32 SOFTWARE SUPPORT (Continued) 


me a a a en es ee ee ee ee ee ee eee ee ee ee ee en ee em ew ee ne een 


TYPE i SOFTWARE PRODUCT {| STANDARD {| OPTIONAL | 

Soe Se Oe 2 EEE CESSES SSSR SSS Se ' 
Utilities | Link x { 

Edit x 

Text x 

Source Updater x 

Copy x 

Library Loader x 

Macro Library x 


Sort/Merge II 
Patch 

0S/32 Spooler 
SPL/32 

Fastchek 
Fastback 

Account Reporting 
Backup 

Error Reporting 
Disk Dump 

Dump Print 

Mirror Disk Synchronizaton 
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* ITC, COBOL and DMS/32 comprise the Perkin-Elmer Reliance 
software system designed for transaction processing. 


1.2.1 Task Management Subsystem 


The task management subsystem allocates processor time for each 
of the tasks executing in an OS/32 multitasking environment. The 
task manager determines the order in which each task gains 


processor control on a_ user-defined priority basis. Task 
priority levels range from 0 to 254 (0 being the highest priority 
level). Of these 255 priority levels, 10 through 249 are 


available for user-written tasks, while 1 through 9 and 250 
through 254 are reserved for system use. 


The task manager maintains four priority levels for each task: 


e Maximum 
e Task 
e Run 


e Dispatch 
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Maximum priority, set by Link, is the highest priority level 
(i.e., the smallest number) that can be assigned to a task. Task 
priority is the priority that is currently assigned to a task. 
Initially, task priority is set when the task is linked, but this 
priority can be changed after the task is loaded. However, task 
priority can never be set higher than the maximum priority set by 
Link. 


Run priority can be set dynamically to a value ranging from the 
task priority to task priority plus n. The value of n is based 
on the behavior of the task. Run priority can only be set for 
tasks that have dynamic time-slice/priority scheduling enabled. 
If dynamic scheduling is not enabled, a task's run priority is 
equal to its task priority. Currently, only MTM enables dynamic 
time-slice/priority scheduling. 


A dispatched task usually has a priority level equal to its task 
priority, even if dynamic scheduling is enabled. Nevertheless, 
if a higher priority task requires specific system resources 
(e.g., a disk directory or bit map) that are currently controlled 
by a lower priority task, the dispatch priority of this lower 
priority task is raised to the priority of the higher priority 
task waiting for the resource. When a task releases control of 
a system resource, its dispatch priority is reset to its run 
priority. 


Tasks competing for processor time are maintained in priority 
order on a task control block (TCB) queue known as the ready 
queue. Tasks competing for both memory and processor. time are 
maintained in priority order on the roll-in queue. Tasks at the 
same priority level are serviced on a round-robin basis; i.e., 
tasks are added to the ready queue or roll-in queue behind tasks 
of the same priority. 


In the absence of time-slicing, once a task gains control of the 
processor, it continues executing until it voluntarily 
relinquishes that control or is preempted by a higher priority 
task. A task will relinquish control of the processor to another 
task when one of the following occurs. 
e It is paused by the system operator. 


e It is cancelled by the system operator, user or another task. 


e A higher priority task becomes ready due to an external event, 
such as the completion of an outstanding I/O request. 


e It executes an SVC that places it in a wait, paused or dormant 
state. 


e It initiates I/O to a device. 


® Its time-slice expires. 
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After the task relinquishes control of the processor, it is 
returned to the ready queue, where its TCB is placed behind the 
TCBs of tasks of equal priority. This allows the other tasks on 
the queue to be given a turn on the processor. 


To determine which task should have control of the processor, the 
task manager chooses the highest priority task among those on the 
ready queue, the roll-in queue, and any currently executing task. 
If a task is chosen from one of the queues, the currently 
executing task is placed back on the ready queue and the chosen 
task becomes the current task. 


The task manager supports two types of time-slicing: 


e@ System time-slice 


® Dynamic time-slice 


System time-slicing limits the execution of a task so that 
round-robin scheduling of priority tasks can take effect. 
Time-slicing allows tasks of equal priority to receive equal 
shares of processing time. 


At system generation (sysgen), system time-slicing can be enabled 
through the use of the SLICE command. This allows time-slice 
scheduling to be activated automatically by the system. 
Thereafter, the operator SET SLICE command can be used to 
override the SLICE command. 


Dynamic time-slicing is enabled only for MTM subtasks. The 
dynamic time-slice is calculated as: 


slice = 1 + 2**m 
Where: 
m = task priority - run priority + 1 
The slice is naasarea in units of line frequency clock (LFC) 


ticks (one LFC tick = 8.333ms). 


Run priority is adjusted whenever a task uses up a time-slice, is 
removed from a wait state, or has its priority modified by the 
operator SET PRIORITY command. When a task uses up a time-slice, 
its run priority is adjusted as follows: 


New run priority = run priority + 1 or ; 
task priority + k (whichever is smaller) 
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Where: 


k = number of dynamically scheduled tasks or 
12 (whichever is smaller) 


Because a task that is placed in a wait state does not use up its 
last assigned time-slice, the run priority of the task, when it 
is removed from suspension, is adjusted as follows: 


Run priority = run priority - 1 or 
task priority (whichever is larger) 


The task manager also performs intratask context switches to 
allow tasks to receive and handle task traps in response to 
synchronous and asynchronous trap-causing events. Synchronous 
events include task-initiated faults (e.g., arithmetic, memory 
access, illegal instruction, etc.) and svc14 traps. 
Asynchronous events’) originate outside of a task and include the 
task queue traps (e.g., I/0 and timer completion, SVC6 send 
message/data and queue parameter, etc.) and the task event traps 
currently associated only with SVC intercept support. 


In addition to task scheduling and task trap support, the task 
Manager handles the state of a task during execution. Task 
execution state is determined by the setting of the program 
status word (PSW). The task manager switches or exits tasks from 
one execution state to another. 

1.2.1.1 Task Scheduling on a Model 3200MPS System 

The OS/32 task manager uses four different types of queues to 
facilitate task scheduling on a Model 3200MPS System: 

e CPU ready queue 

@ CPU receive queue 


e CPU roll-in queue 


@ APU execution queue 


An APU execution queue can be one of four different types: 


e APU idle queue, not serviced by any processor 
e APU private queue, serviced by a single APU 


e APU shared queue, serviced by several APUs 
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@ CPU/APU shared queue, serviced by the CPU whenever its own 
ready queve is empty and/or by one or more APUs; this is 
always APU execution queue 0. 


Each APU execution queue can be designated either no-priority or 
priority-ordered. Priority-ordered queues can be either enforced 
or not enforced, depending upon whether a task put on the top of 
the queue preempts a currently executing task of lower priority. 
The CPU ready queue is priority-enforced, and the CPU receive 
queue is no-priority. 


When a task requests processor time on a Model 3200MPS_ System, 
the task manager adds the TCB for that task to the CPU ready 
queue. The task manager selects a task for execution from the 
queue on ae strict priority basis. After selecting a task, the 
task manager then decides whether the task is to be executed on 
the CPU or placed on one of the APU queues in the system. A task 
is transferred to an APU queue for processing only when all of 
the following conditions are true: 


@e The task must be executing in the user state, not in the 
system state. 


e® The task's "LPU-directed" status must be set. (In MTM, when 
the load-leveling executive (LLE) is active, subtasks of MTM 
cannot be LPU-directed unless the user has SVC6 privileges. ) 


e The task status word (TSW) does not specify CPU-override 
status. (If the CPU-override status bit of the TSW is set, 
the task is executed on the CPU.) 


When all of the above conditions are true for the highest 
priority task on the CPU ready queue, the task manager transfers 
the TCB for that task from the CPU ready queue to an APU queue. 
If the APU is waiting for the task (i.e., APU processing has been 
suspended until the task arrives), the TCB becomes the current 
TCB and execution begins immediately. If the APU is not waiting 
for the task, the TCB is placed on the APU queue. 


Whenever it is not processing a task, the APU continually checks 
its APU queue. If the APU finds entries on the queue, it will 
execute the task at the top of the queue. 


Once the APU starts a task, the task will execute until it: 


@ relinquishes control voluntarily (reschedules itself), 
@® encounters a fault, 
@e issues an SVC, or 


@ is returned to the CPU via an operating system request on 
behalf of a monitoring task, operator command, etc. 
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The task may reschedule itself to the rear of the APU queue or to 
the CPU. In a no-priority APU queue, the task is placed at the 
bottom of the queue. In a priority APU queue, the task is placed 
behind all tasks of equal or higher priority, or at the queue top 
if there is no task of equal or higher priority on the queue. In 
a priority-enforced APU queue, the task is placed on the queve in 
the same manner as for a priority queue. In addition, whenever 
the task happens to be placed at the queue top, the operating 
system executes the preempt procedure to ensure execution of the 
highest priority tasks, even if a lower priority task is 
currently executing. 


The task is returned to the CPU receive queue if it is 
rescheduled to the CPU, if a fault occurs, or if an SVC or 
operating system request occurs. The task waits on the receive 
queue until the CPU places the task on the CPU ready queue. 


If the task is placed on the receive queue as a result of a 
fault, the task is moved to the CPU ready queue. If the 
appropriate bits in the TSW are set, the task's TSW location is 
set to the address of the task trap handler. The task can then 
be dispatched back to the APU quéue. 


If the task is placed on the receive queue as a result of issuing 
an SVC, the task is moved to the CPU ready queue and executed on 
the CPU until SVC processing is complete. The task can then 
automatically move back to the APU quéue. 


Rollable tasks are moved from the roll-in queue to the CPU ready 
queue and are processed in the same manner as any other task 
running on a Model 3200MPS System. Rollable tasks may be 
dispatched to an APU. 


Tasks running under MTM will run on APUS as determined by the LLE 
at a priority scheduled by the priority scheduling mechanism 
(PSM). When the LLE is active, MTM controls whether the task 
will be assigned to one of the APUs or to the CPU. 


1.2.2 Job Accounting Subsystem 

The job accounting subsystem reports CPU usage and time elapsed, 
memory and disk space utilized, and number and length of I/O 
transfers by device class. The job accounting subsystem contains 
Lhe: 

@e Data Collection Facility 

@ Account Reporting Utility 

The Data Collection Facility collects accounting data on 


all user activities and stores this information in the 
accounting transaction file (ATF) when the task terminates. 
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The Account Reporting Utility is designed to accommodate specific 
customer site requirements. The performance information gathered 
by the Data Collection Facility is prepared by the Account 
Reporting Utility for use by system maintenance personnel. 
Reports can be requested for individual user accounts, summaries 
of user accounts and system usage. See the 0S/32 System Support 
Utilities Reference Manual. 


Through the DISPLAY ACCOUNTING command, the system operator has 
access to accounting data for one or all tasks in the system. 
This command also gives MTM users access to accounting data for 
a task monitored by MTM on their behalf. 


NOTE 
The OS/32 job accounting subsystem now 
reports APU usage and time elapsed in a 
Model 3200MPS System. 
1.2.3 Memory Management Subsyst.em 
When a task is loaded, the memory management subsystem 


dynamically allocates necessary space in memory. 0OS/32 supports 
three types of memory: 


® Local 
e Shared 
e® System 


Local memory is physically contiguous starting from location 0 
and contains the operating system, task space and system space. 


Shared memory is located above local memory and is not required 
to be contiguous. Global task common segments located in shared 
memory can be used by more than one processor. 


System memory is shared by all processors in a Model 3200MPS 
System. System memory contains both local and shared areas. 
Local memory is used by the CPU and all APUs. 


Local memory is allocated on a first-fit basis when sufficient 
memory is available for a specific task. Free segments are 
allocated in ascending address order. When no space is available 
for a task, the memory manager determines which tasks are to be 
rolled out to ensure that higher priority tasks take precedence. 
When memory becomes free, adjacent areas are merged together to 
minimize search time and to provide large free blocks of memory 
for bigger tasks. System task space is also maintained by the 
memory manager and is dynamically allocated when a task or device 
structure is built. 
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The memory manager maintains task space through free and 
allocated lists. Segments are allocated dynamically on a 
first-fit basis by searching the free lists. When free task 
space is allocated to a segment, it is removed from the free list 
and connected to the allocated list. This list is called the 
segment control list (SCL). Similarly, whenever a#§segment is 
released, its memory space is removed from the allocated list and 
connected to (or merged into) the free list. 


1.2.4 Timer Management Subsystem 

The timer management subsystem provides tasks with a set of timer 
management/maintenance services. These services control all 
time-dependent functions (e.g., time-slicing, I/0, job accounting 
and file dating) through the universal clock (UCLOCK). 

The following timer queues are maintained by the timer management 
subsystem: 

@ Time of day 

@e Device time-out 

e@e Communications device time-out 

® Interval timer 


There are several timer routines that service these queues. 
Entries are placed on the time of day queue and the interval 


timer queue as a result of SVC2 timer requests. The control 
blocks on the time of day queue are referred to as timer queue 
elements (TMQs). The interval timer queue has the same format as 


the time of day queue but is maintained as a separate queue. 


The UCLOCK consists of an LFC and a precision interval clock 
(PIC). In a 60Hz system, the LFC generates an interrupt every 
8.3ms or 120 times per second. In a 50Hz system, the LFC 
generates an interrupt every 10ms, or 100 times per second. The 
PIC interrupts when a task's requested time interval has expired 
or at intervals of 4,096ms, whichever is’ shorter. If the 
interval terminates or the time of day is reached, the TMQ is 
removed from system space and a trap is generated, or the task is 
removed from timer wait. 


In a Model 3200MPS System configuration, the real-time support 
module (RTSM) provides each processor with a 32-bit real-time 
counter for timing program execution. These counters are 
incremented every microsecond by an RTSM I1MHz on-board 
oscillator. The RRTC instruction allows tasks to read the 
counters. See the Perkin-Elmer Model 3200MPS System Instruction 
Set Reference Manual for more information. 
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1.2.5 File Management Subsystem 


The OS/32 file management subsystem stores and retrieves 
information for a task on secondary’ storage devices (disks, 
floppy disks, etc.). The file manager partitions this storage 
into smaller areas, called files, that can be used by tasks for 
data and program storage. In addition, the file manager provides 
tasks with the following support services for file management: 


Allocate creates a file by allocating space on a 
secondary storage device. 

Delete | removes a file from a_ secondary storage 
device. 

Rename changes the name of a file. 

Open assigns a logical unit (lu) to a file. 

Close cancels the lu assignment. 

Fetch examines the attributes of a file. 

attributes 

Checkpoint. ensures that all data in an output buffer is 
written to a secondary storage device. 

Software selects recording density for 6250 bits 

density per inch (bpi) magnetic tape drives. 

selection 


1.2.6 Input/Output (1/0) Subsystem 


The I/O subsystem provides a uniform programming interface 
between the task and external devices. I/O operations can occur 
in the following task modes: 


Wait halts execution until data transfer is 
completed. 

Proceed 1/0 continues task execution dquring data transfer. 

Halt I/O allows the task to cancel previous proceed I/O 
requests. 

Queued 1/0 allows a task to queue I/O requests to a_ busy 
device and continue execution until the device 
is free. 


A task trap mechanism can be used to report each completed 1/0 
operation. Wait-only and test I/O functions allow the task to 
synchronize its execution with the completed I/O operations. 
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1.2.7 Error Recording Subsystem 


The error recording subsystem logs all data on disk errors for 
the Error Reporting Utility, which analyzes the data and 
generates reports. 


0S/32 memory error recording software supports the memory error 
log hardware of the Perkin-Elmer Series 3200 processors. Error 
log hardware keeps a history of the single-bit corrected memory 
errors. The operating system reads the error log hardware and 
stores the error information into an internal error log buffer. 
When the error log buffer is full, its contents are stored on an 
error recording file with the date and time of the last error 
recorded. When the error recording file is almost full, a 
warning message is displayed on the system console indicating 
that a new error recording file should be allocated or that the 
Error Reporting Utility should be initiated.. The Error Reporting 
Utility provides reports on the previously recorded error 
information in the error recording file. 


The current error status can be displayed to the system console 
by using the DISPLAY ERRORS command. The internal error log 
read-out period can be changed by the system operator. 


1.2.8 Memory Diagnostics Subsystem 


The memory diagnostics subsystem eliminates inoperable memory 
areas from the system without affecting task execution. It 
allows the operating system to execute when portions of real 
memory have been removed (holes) or when a part of the system is 
powered down for maintenance. Memory can be tested and marked on 
and off through the operator MEMORY command or when the operating 
system is initialized. 


The marked-off areas are noted as allocated in the memory map. 
Memory is marked-on when previously marked-off memory is to be 
used again. If an irrecoverable memory error occurs during task 
execution on a Perkin-Elmer Series 3200 processor, the operating 
system automatically marks off the area occupied by the task. 


1.2.9 Loader and Segmentation Subsystem 


The OS/32 resident loader is responsible for loading tasks, 
reentrant libraries, task common (TCOM) segments, and partial 
images. These tasks and segments must have been built by Link. 
Each task image generated by Link contains information related to 
the task (e.g., task options, size, libraries referenced) ina 
record called the loader information block (LIB). The OS/32 
resident loader uses this information to generate data areas, set 
the task options, create segment tables for the tasks and map the 
task segments. 
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All user tasks (u-tasks) in OS/32 are built as though they were 
loaded at physical address 0 in memory . The 
relocation/protection hardware automatically relocates the task 
addresses at run-time by using the task segment table. This 
process is totally transparent to the user. 


The loader is also responsible for creating the task environment; 
allocating roll files; creating, maintaining and deleting segment 
tables; maintaining a segment control list; and mapping and 
unmapping partial images. 


The task image can be divided into pure and impure segments’ by 
specifying the SEGMENTED task option when the task is built by 
Link. Regardless of the number of times a task is loaded, the 
loader will allow only one copy of the task's pure segment in 
memory at any one time. A separate copy of the task's impure 
segment is loaded each time the task is loaded. The 
relocation/protection hardware ensures the integrity of pure 
segments by allowing read-only and execute-only access privileges 
to those segments. 


Access to task common is achieved mnemonically in FORTRAN or 
assembly programs. The linkages are resolved by Link. Link 
commands are also used to request read, write and execute 
privileges for task common blocks. See the 0S/32 Link Reference 
Manual for more information. 


1.2.10 Basic Data Communications Subsystem 


The basic data communications subsystem provides a _ software 
interface between tasks and common carrier facilities. Basic 
data communications facilities allow the user to access’ remote 
terminals or computers as though they were locally attached 
peripherals. For example, with 0OS/32 Data Communications 
software, a task performs I/O to a remote terminal in the same 
manner as I/O to a local device. 


In addition to providing device-independent (logical I/0) access 
to the task, the subsystem provides a device-dependent I/0 
capability that allows the systems programmer to tailor a 
communications package to a particular installation. Sucha 
package can include device-dependent and device-independent 
support of asynchronous line devices as well as device-dependent 
support of binary synchronous lines. 


The OS/32 Basic Data Communications software support package is 
required for all 32-bit communications products; e.g., HASP, 
2780/3780 Remote Job Entry, the zero-bit data link control (ZDLC) 
Channel Terminal Manager and the Ethernet Data Link Controller 
(EDLC), which support the synchronous data logic control (SDLC), 
high-level data link controller (HDLC) and advanced data 
communications control procedure (ADCCP) protocols. 
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1.2.11 Console Monitor Subsystem 


The console monitor subsystem processes all I/O requests directed 
to the system console device and the system log device from all 
tasks including the command processor task. The console driver 
is responsible for intercepting system console I/O requests and 
for directing them to the console monitor or to another monitor 
task such as MTM. All I/O operations between the system console 
and tasks running under MTM are routed to the user's terminal 
through MTM and not through the console monitor. 


When a command is issued from the system console, the _ console 
monitor issues an SVC6 to the command processor notifying it of 
a command to be processed. The command processor interprets the 
command and issues an SVC6 to the console monitor indicating that 
it is ready to accept another command. 


The console driver is a part of the 05/32 I/O subsystem and is 
the module that intercepts I/O requests to the system console, 
processes them, and gives them to MTM or to the console monitor 
to perform the actual I/O. 


The console monitor is the first task dispatched at 08/32 
initialization. The console monitor initializes both itself and 
the dummy device control block (DCB) used by the console driver 
to intercept requests from the system console. The monitor then 
issues an SVC6 to start the command processor. 


1.2.12 Command Processor Subsystem 


The command processor subsystem accepts commands from the system 
console monitor, decodes them, and calls the appropriate 
executor. Commands can be input to the command processor by 
entering them directly through the system console or issuing them 
through a foreground task that uses the system console as an 
interactive I/O device. Commands input from a foreground task 
are executed by the command processor in the same manner as 
commands entered from the system console. If an error occurs 
during execution of a command, the command processor outputs an 
error message to the console. 


An extension to the command processor, the command substitution 
system (CSS) allows commonly performed sequences of operations to 
be executed with one command. The CSS routines provide the user 
with the ability to build, execute and control files of operator 
and MTM commands. The user establishes command files that are 
called from the user console and executed in the user-defined 
sequence. In this way, complex operations can be carried out by 
the user with few commands. These commands are analogous to 
macro instructions in assembly language. 
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The CSS provides a set of logical CSS commands to conditionally 
control the. precise sequence of commands to be executed. 
Parameters can be passed as part. of a CSS call so that general 
sequences can be written that take on specific meaning only when 
the parameters are substituted. Other calls to CSS files can be 
imbedded within a CSS file (nested calls). 


The command processor normally runs at the second highest 
priority level after the console monitor in OS/32. This task is 
Strictly trap driven and responds to the SVC6 task queue 
parameter calls from the console monitor to service a command 
request. When the command is processed, it signals the console 
monitor for a new command read via an SVC6 queue parameter call 
and then enters into a trap wait state. The command processor 
priority can be decreased by the operator ATTN command. This 
command can be used in a real-time application environment to 
allow a task to run at a higher priority than the command 
processor. 

1.2.13 System Initialization Subsystem 

After the operating system is loaded, the system initialization 
subsystem initializes the memory diagnostics subsystem, error 
recording subsystems, and system control blocks and tables in 
memory. It then dispatches the console monitor, which readies 
the command processor to accept commands from the system console. 
1.2.14 Internal Interrupt Subsystem 


The internal interrupt subsystem is responsible for: 


@ handling illegal instruction faults, 

@ handling arithmetic faults, 

@ detecting memory faults, 

e handling system queue service (SQS) interrupts, 

@e handling relocation/protection hardware faults, » 
@e handling data format/alignment faults, 

e handling power fail and power restore conditions, 


e restoring an interrupted task to its previous program state 
upon resumption of the task, 


e handling parameter block errors, 


48-040 FOO ROS 1-17 


@ handling illegal SVCs and SVC interrupts, 
@ handling machine malfunction interrupts, and 


® performing memory image dumps. 


Processor-dependent interrupt handlers comprise the _ internal 
interrupt subsystem. This subsystem does not support external 
I/O interrupts; they are handled by the appropriate device 
drivers. 


On a Model 3200MPS System, the CPU handles all fault conditions 
or interrupts that occur during execution of a task on an APU. 
Thus, the APU can execute another task while the CPU is handling 
the fault or interrupt. 


1.2.15 Optional User Supervisor Call (SVC) Subsystem 

$VC14 is provided as an optional SVC that can be defined by the 
user. On execution, the task receives a task trap for SVC14. 
See the OS/32 Application Level Programmer Reference Manual _ for 
information on how to implement the SVC14 trap feature. 

1.2.16 Floating Point Subsystem 


A task has optional access to single and/or double precision 


floating point instructions. under 08/32. Floating point 
instructions can be executed through hardware or simulated by 
software. Systems that do not support floating point options 


handle all floating point instructions as illegal instructions. 
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CHAPTER 2 
PRIVILEGED TASKS 


2.1 INTRODUCTION 


In a multi-user system, improper use of certain machine 
instructions, called privileged instructions, can have a 
detrimental effect on system integrity. Privileged instructions 
include storage protection setting, interrupt handling, timer 
control, input/output (1/0) and some processor status-setting 


instructions. To prevent accidental or intentional misuse of 
these instructions, OS/32 provides a privileged operating state 
in which tasks can execute these instructions. In addition to 


the privileged operating state, OS/32 provides a privileged task 
state in which tasks can access the file account and bare disk 
OS/32 supervisor routines. 

Only privileged tasks can execute in a privileged operating or 
task state. OS/32 allows three types of privileged tasks: 

e Executive tasks (e-tasks) 

@ Privileged user tasks (u-tasks) 

@ Diagnostic tasks (d-tasks) 


A task can be linked as a privileged task by specifying one or 
more of the following task options in the Link OPTION command: 


ETASK, ACPRIVILEGE, DISC, DTASK 
See the OS/32 Link Reference Manual. 


This chapter describes the privileges that are available to each 
type of privileged task through the Link OPTION command. 
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2.2 EXECUTIVE TASKS (E-TASKS) 


E-tasks run with the memory address relocation/protection 
hardware and are allowed to execute all instructions provided by 
the hardware. E-tasks always have file account and bare disk 
privileges. In addition, e-tasks can execute code that modifies 
or enhances the 0S/32 system software. For example, an e-task 
can modify one of the system modules to enhance an existing 08/32 
feature. E-tasks can also function as drivers that support 
nonstandard peripheral devices. A task can be linked as an 
e-task by specifying the ETASK task option in the Link OPTION 
command. The following sections detail the programming 
considerations that must be taken into account when writing 
e-tasks. 


2.2.1 Writing Executive Tasks (E-Tasks) 


Because e-tasks execute in a privileged state, certain 
precautions must be taken when e-tasks are programmed. 


When an e-task is executing, no memory address protection or 
relocation is provided and all interrupts are enabled. The task 
has access to all machine instructions and memory address space 
in the system. In addition, the e-task can access system tables 
and control information via the system pointer table (SPT). The 
address of the SPT is stored in the halfword at location X'62' in 
memory . 


Link builds the image for an e-task as if it were loaded at 
absolute location zero. The loader, however, is free to load the 
e-task into any available memory location. Therefore, an e-task 
must be coded as if it were positionally independent; an e-task 
must not contain relocatable code. 


Because Link relocates e-task addresses to absolute zero, e-tasks 
cannot assemble code containing address constants as shown in the 
following example. 


Example: 


SVC7BLK DB X'80',7 
DAC ADDR 


An e-task must. dynamically set the addresses required by the 
task. 
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To reference addresses in the +16kb range, use the _ following 
technique: 


UE, BUFSTART 

UF , BUFEND 

U3 ,SVC1PBK 
UE,SVC1.SAD(U3) 
svc 1,0(U3) 


BEES 


References to addresses exceeding the 16kb range can be made in 
the following manner. 


Example: 


BASE - LA U4,BASE 
LA UE , BUFSTART-BASE (U4) 
LA UF , BUFEND-BASE(U4) 
LA U3, SVC1BLK-BASE (U4) 
STM  UE,SVC1.SAD(U3) 
svc 1, 0(U3) 


E-tasks smaller than 16kb must use the no RX3 _ (NORX3) (CAL/32) 
instruction to force all RX instructions to the RX1 or RX2 
format. The tasks must not contain any RX1 or RX3_ instructions 
with relocatable addresses. See the Common Assembly Language/32 
(CAL/32) Programming Reference Manual. 


2.2.2 OS/32 Data Structures Used by Executive Tasks (E-Tasks) 


OS/32 provides two macro libraries that contain OS/32 and 
multi-terminal monitor (MTM) data structures. The OS/32 data 
structure macro library is stored in file SYSSTRUC.MLB. Table 
2-1 contains a list of the macros and corresponding data 
structures in this library. Data structures specific to the MTM 
subsystem are stored in file MTMSTRUC.MLB. The contents of this 
library are listed in Table 2-2. 


Using the 0OS/32 e-task capability and the data structures 
available to e-tasks, the system level programmer can incorporate 
changes or add user-written modules to the source of the 0S/32 
system modules supplied by Perkin-Elmer. 
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TABLE 2-1 0OS/32 DATA STRUCTURES MACRO LIBRARY 


MACRO 


ee 


$ACB 
$AOPT 
$APB 
$APB$ 
$APRC 
$APS 
$APST 
$ATF 


$CCB 
$CTX 


$DATB 
$DCB$ 
$DDCB 
$DDE 

$DFLG 
$DIR 

$DXFL | 


$EMIL 
$EFMG 
$EREGS 
$ERRC$ 
$ESYS 
$EVN 


$FCB 
$FCBS$ 
$FDE 
$FFLG 
‘$FD 


$GERC 
$HB 


INTCPARM 
$ICB 
$IOB 
$IOB$ 

$ IOBF 

$ 10H 
$IPCB 
$IRCB 
$IVT 


DATA STRUCTURE 


Directory access control block (ACB) 
Auxiliary processing unit (APU) options 
Auxiliary processor block (APB) 

$APB, $APRC, $APS, $AOPT 

Passback reason codes and equates 

APB status codes and equates 

APU status codes, error codes and equates 
Account transaction file (ATF) 


Channel control block (CCB) 
U-task context block 


Device attributes equates 


$PDCB, $DDCB ,DCB EQUATE, $DFLAG, §$DATB, $DXFL 
Device-dependent device control block (DCB) 


Error log data structure 
DCB flags 

Primary directory entry 
Disk-extended flags 


System milestone recording entries 
Bulk device error recording entries 

16 executive registers (El=register 1) 
$GERC, $EFMG, $ESYS, $EMIL, $MERC 
System error recording entries 

Event node 


File control block (FCB). 
FCB and FCB flags 

Free block descriptor entry 
FCB flags 

File descriptor (fd) 


General error recording information 
Help subroutine argument block 


Supervisor call (SVC) intercept information 
Intercept control block 

I/O block 

1/O and 1/0 flags 

I/O block flags 

I/O handler list 

Intercept path control block 

Intercept control block 

Initial value table 
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TABLE 2-1 OS/32 DATA STRUCTURES MACRO LIBRARY (Continued) 


{| MACRO | DATA STRUCTURE 

| HSS SS SE RR SSR SEES SS SSS SSS ESSE EER EEE EEE EEE Eee eee 
|} $L1B | Loader information block (LIB) 

| $LIB$ i} LIB and loader options 

| $LLE } Load leveling executive (LLE) 

| $LPMT | Logical processor mapping table (LPMT) 
| $LOPT | Loader options 

| $LSG | Load segment 

| $LTCB | Loader task control block (TCB) redefinitions 
| ! 

! 1 

| $MAGDCB {| Magnetic tape DCB 

} $MERC } Memory error recording entry 

I 1 

' ' 

} $O0CB ij Overlay control block 

} $ODT | Overlay descriptor table (ODT) structure 
} $ORT i Overlay reference table 

' i] 

' ' 

| $PDCB i Primary (device-independent) DCB 

| $PFCB i Private FCB 

| $PSDCB i Pseudo DCB structure (device-dependent) 
i $PSTCB | Pseudo TCB 

i $PSW | Program status word (PSW) 

! ' 

' 1 

| $QH | SVC intercept queue handler structure 

| $QPB i Queue parameter biock (QPB) 

| $QPB$ = |: $QPB, $QPSTAT 

| $QPSTAT |} QPB status 

' ' 

1 ' 

| $RCTX | RS/RSA context block 

| $REGS$ | $SOPT, $UREGS, $EREGS, $RREGS, $PSW 

i} $RLST } Roll selection list 

| $RREGS } 16 general user registers (Rl = register 1) 
| $RSARCPY | Reentrant system state alternate save area 
H 1 , 

| $S1X0 | SVCl extended options masks 

| $SDCB | Pseudo print DCB structure 

| $SD i Send data message block 

| $SDE | Segment descriptor element 

} $SOPT i System options 

|} $SPLMSG | Spooler message structures 

| $SPT | SPT 

| $SPTE | SPT extern definitions 

| $SPOL | Spooler message 

| $STE ; Segment table entries (STEs) 

| $SPR i Segment privilege flags 

} $SVC1 } Svcl 

i $SVC1$ i SVCl and SVCl error codes 

| $SVCI1ERR | SVCl error codes 

i $Svc4 | System SVC - reserved 

' $Svcs i SVC5 parameter block 

i} $SVC6 | SVC6 parameter block 

| $SVC7 i SVC7 parameter block 
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TABLE 2-1 OS/32 DATA STRUCTURES MACRO LIBRARY (Continued) 


ne ee te ee ee eee ce ee ee ee ee ee ne re ee ee ee ne re ee ee eam me a ee ne te me ae com mee ee Se 


MACRO | DATA STRUCTURE i 
$SVC7EXT | Extended SVC7 functions i 
$SVC7SPL | Spooler SVC7 parameter block H 
$SVC13 } SVC13 parameter block H 
$SVC13$ | $SVC13, $APST H 
$SVT { System value tab H 
$SYP | System space structure H 
$$SPT | SPT table definitions | 

i) 1 
i ( 
$TABLS$ | Structure/extern generating macro i 
$TCB } TCB, $SDE, $IOB$, $TCB, $CTX | 
$TCB$ | $TCB, $TOPT, $TSTT, $TWT, $TLFL, $PSTCB, $OCB, } 
| $TQE, $TFL, $TPRC, TQH H 
$TFL. | TCB flags | 

$TKO | Task queue head H 
$TLFL, {| Logical unit (lu) table of flags H 
$TMQ {| Timer queue entry ! 
$TOPT | Task options flags I 
$TPRC | Task passback codes i 
$TOE | Task event queue entry | 
$TQH | Task event queue header H 
$TQ27 | SVC2 code 27 parameter block i 
$TSTT | Internal task status flags H 
$TSW ' Task status word (TSW) H 
$TTB | APU trap block i 
$TWT | Task wait status flags i 

1 i) 
4 ' 
$UDL | User-dedicated locations (UDLs) | 
$UDLS§ }| UDL and TSW | 
$UREGS | 16 general user registers (Ul = register 1) H 
i i 
$VD {| Volume descriptor H 

$VFCHARS | Vertical forms control (VFC) characters i 

$VFDCB } Common VFC DCB structure | 
| 
$WAP | Read/write access matrix header structure { 


ee ne nnn nn nn nc rnc eee acdieaianciantetindiatentandineaalinstiaaliaatanatneateadmetn ate iatieenianntinel 
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TABLE 2-2 MTM DATA STRUCTURES MACRO LIBRARY 


i MACRO i DATA STRUCTURE H 
{ SESE rr SS SS SSS SSS SSE OCS STSCI ES STE KC ESSE SK SSK SS SE SK SSS SS SS | 
} $TERMUSR {| Terminal user block H 
| $AUF ' Authorized user file (AUF) record i 
| $MTMSTE | Terminal state definitions i 
i} $PRIV i User privileges i 
i $VAR i Command substitution system (CSS) { 
H { variable flags and structures H 
| $BTQ { Batch queve header and entry structures j; 
i} $CMB i Command buffer structure H 
| $LMB | Log/broadcast message buffer structures j; 
{ $CBH } Common buffer header structure H 
| $CSTK | CSS pointer stack structure } 


2.3 PRIVILEGED USER TASKS (U-TASKS) 


Like nonprivileged u-tasks, privileged u-tasks run with the 
memory address relocation/protection hardware ‘enabled and are 
restricted to a subset of instructions known as_ nonprivileged 
instructions. If a u-task attempts to execute a privileged 
instruction, it causes an illegal instruction fault. However, 
unlike nonprivileged u-tasks, privileged u-tasks have file 
account and bare disk privileges. File account privileges allow 
tasks to specify an account number in the file account/class 
field of a fd. Bare disk privileges allow tasks to perform I/O 
operations to a bare disk device. See the OS/32 Supervisor Call 
(SVC) Reference Manual. 


A u-task acquires file account and bare disk privileges by 
specifying the ACPRIVILEGE and DISC task options, respectively, 
in the Link OPTION command when the task is built. 


2.4 DIAGNOSTIC TASKS (D-TASKS) 


D-tasks, like e-tasks, can execute all instructions provided by 
the hardware. However, like u-tasks, d-tasks run with the memory 
address relocation/protection hardware enabled and execute in the 
nonprivileged task state. D-tasks are designed for use in 
diagnostic applications, loading writable control store (WCS), 
and direct execution of 1/0 instructions. 


A task can be linked as a d-task by specifying the DTASK task 
option in the Link OPTION command. To execute in the privileged 
task state, a d-task must be built with the ACPRIVILEGE and DISC 
task options enabled. 
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CHAPTER 3 
PROGRAMMING IN A MODEL 3200MPS SYSTEM 
MULTIPROCESSING ENVIRONMENT 


3.1 INTRODUCTION 


Programming in a Model 3200MPS System multiprocessing environment 
is similar to programming in a_uniprocessing environment. 
However, due to the nature of the hardware configuration, the 
Model 3200MPS System environment offers one major programming 
advantage: increased throughput. For efficient use of this 
expanded computing ability, the system level programmer = should 
take the following into consideration: 


e The selection of tasks that are to be executed on auxiliary 
processing units (APUs) 


e The preparation of the APUs for task execution 
e The assignment of tasks to the processors 
@ The establishment and control over the order of task execution 


e The prevention of invalid data variables, caused when two 
tasks running on different processors concurrently read and 
modify a common data structure 


e The measurement of real-time performance of the individual 
tasks in the system 


e The customization of APU fault handling 


This chapter focuses on some techniques that can be used by an 
assembly language programmer in solving some of the programming 
problems that are ‘unique to the Model 3200MPS System 
multiprocessing environment. For additional information on Model 
3200MPS System programming, see Table 3-3 at the end of this 
chapter. 


3.2 DESIGNING TASKS TO RUN ON A MULTIPROCESSING SYSTEM 
The main performance advantage of designing an application to run 
on a multiprocessing system is that a job can be broken down into 


several parts that can be run on different processors 
simultaneously. 
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A job can be divided among a number of tasks that control 
individual operations, such as process input/output (1/0), 
perform calculations resulting from a particular action, and 
provide an operator interface for reporting and responding to the 
results of the calculations. 


The individual APUs running these tasks can transmit all status 
information regarding the components of the system to another 
task, called the supervisor monitor. The supervisor monitor can 
then output messages to a console or printer as the status is 
received. Another function of the supervisor monitor is to store 
a code in a status word in memory that can be accessed by a 
standby task. The standby task then would he able to 
periodically check the status of the system and adjust task 
execution accordingly. 


Once the programmer has divided a job into several tasks that can 
be run simultaneously, the next step should be to assign each 
task to an APU for execution. It should be remembered that 
execution of a computation-intensive task on an APU increases 
overall system performance, while an I/O-intensive task running 
on an APU decreases system performance. Because the operating 
system executes exclusively on the central processing unit (CPU), 
each I/O request made by an APU task causes the task's execution 
to transfer back to the CPU for operating system support. All 
1/O-intensive tasks should be assigned to the CPU for execution. 


3.3 PREPARING AN AUXILIARY PROCESSING UNIT (APU) FOR TASK 
EXECUTION 


OS/32 supports a multiprocessing configuration consisting of one 
CPU and one to nine APUs. The operating system schedules tasks 
for execution by arranging them in queves. These queues’ consist 
of a CPU ready queve and APU execution queues. 


3.3.1 Queue Assignments 


The CPU ready queue is intended for supervisor call (SVC) 
I/O-intensive tasks and is serviced by the CPU. The APU queues 
are numbered 0 through n where n represents the number of APUs in 
the system. They are intended for the computation-intensive 
tasks and are serviced by APUs assigned to them. APU queue 0 is 
serviced by the CPU when the CPU ready queue is empty. The APU 
execution queues numbered 1 and above are also referred to as 
APU-only queues. 


The APU-only queues may have the following assignment 
possibilities: 


@ The queue is idle with no APUs assigned 
e The queue is private and has one APU assigned 


e ‘The queue is shared with two or more APUs assigned 
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When the operating system is loaded, each of the APU-only queues 
is designated as a private queue and is assigned to one APU. The 
number of the queue will correspond to the number of the APU to 
which it is assigned. Subsequently, the APUs may be reassigned 
using a corresponding SVC13 control function or the operator 
command APC. To employ an SVC13 control function, a task must be 
linked using the OPTION APCONTROL command of LINK. 


3.3.2 Auxiliary Processing Unit (APU) Operating States 
0S/32 maintains two operating states for an APU, each differing 


in the degree of APU readiness for task execution. These states 
are: 


DISABLED APU is unavailable for all purposes’ except 
running the power-up link check procedure. 

ENABLED APU has successfully passed the power-up link 
check procedure and is ready for task 
execution. 


All APUs are put into the DISABLED state upon operating system 
load or power restore. On a power fail restart, an attempt is 
made to upgrade each APU not disabled prior to the power fail to 
the ENABLED state. 


The transition from one APU state to another can be accomplished 
along the paths shown in Figure 3-1. These transitions are 
executed by the corresponding SVC13 control functions or _ the 
operator APC command. The APU firmware logic requires resetting 
the APU state after it is disabled in order to be enabled again. 
The resetting is done using the appropriate button on the APU 
board or by powering down the APU cabinet. 
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MARK ENABLED 


Figure 3-1 Valid APU Operating States 
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3.3.3 APU-Only Queue Operating States 


OS/32 maintains three operating states for each APU-only queue, 
each differing in the degree of queue availability for task 
scheduling. These states are: 


OFF APU queue is not available for task 
scheduling. 


ON EXCLUSIVE APU queue has only a designated task scheduled 
to it. (Only an idle or private APU queue can 
be marked ON EXCLUSIVE. ) 


ON APU queue is fully available for task 
scheduling. 


All the APU-only queues are put into the OFF state upon operating 
system load. Upon a power fail restart, the load power fail 
monitor (LPFM) restores the queue states. The queue O is always 
maintained in the ON state. 


The transition from one APU queue state to another can _ be 
accomplished along the paths shown in Figure 3-2. These 
transitions are executed by the corresponding SVC13 mapping 
functions or the operator QUEUE command. To use an SVC13 mapping 
function, a task must be linked using an OPTION APMAPPING command 
of LINK. 
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Figure 3-2 Valid APU Queue Operating States 
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* The following code demonstrates how SVC13 

* is used to enable an APU and mark on the queue * 
x for task scheduling. This example does not x 
x check for SVC13 execution errors. A task incor- x 
x porating this code must be linked using a LINK x 
* x 
x * 


command OPTION APCONTROL., APMAPPING. 
SOI OI III IOIIORIOOI OIG IGG CIGIOIGICI GI GIOI IGG IGOR II IO III III. 


48-040 FOO RO3 3-5 


Example: 


$SVC13 

ALIGN 4 
ENABLE DS SVC13 ALLOCATE STORAGE FOR SVC 13 PARBLK 
ENABLEE EQU 7 
*GAIN CONTROL RIGHTS, ENABLE APU, START APU, ASSIGN TO QUEUE, 
*RELEASE CONTROL RIGHTS 

ORG ENABLE+SV13 .OPT 


DB x'cD' 

ORG ENABLE+SV13 . FUN 

DB X'03' FUNCTION CODE=3 

ORG ENABLE+SV13 .DOP 

DB x'Ol1' SEND START APU COMMAND 
ORG ENABLE+SV13 . APN 

DB 2 APU NUMBER 

ORG ENABLE+SV13 .USE 

DCX 3 ASSIGN APU TO QUEUE 


ORG ENABLEE 
***RBUILD SVC 13 PARAMETER BLOCK FOR MARKING QUEUE 
ALIGN 4 
MARK  #£«ODS svcl3. ALLOCATE STORAGE FOR SVC 13 PARBLK 
MARKE EQU * 
xGAIN MAPPING RIGHTS, MARK QUEUE ON, MAP LPU, 
*RELEASE MAPPING RIGHTS 
ORG MARK+SV13 .OPT 


DB X'B1l' 

ORG MARK+SV13.FUN 

DB 2 FUNCTION CODE=2 

ORG MARK+SV13.DOP 

DB 2 LPU NUMBER TO BE MAPPED 
ORG MARK+SV13.APN 

DB 3 QUEUE TO MAP LPU TO 


ORG MARKE 

*****x*TSSUE SVC 13 TO ENABLE APU AND MARK QUEUE*****x* 
svc 13 , ENABLE ENABLE APU 
SVC 13 ,-MARK MARK QUEUE ON 


3.3.4 Logical Processing Unit (LPU) Mapping 


For the purpose of directing tasks to the queves, OS/32 defines 
LPUs ranging from 0 to 255. LPUs are mapped into the APU queues 
while each task is associated with a particular LPO. 


All the LPUs are initially mapped to queue 0 at operating system 
load time. LPUs 1 through 255 can later be mapped to other 
queues using a corresponding SVC13 mapping function or _ the 
operator LPU command. LPU 0 always remains mapped to queue 0. 
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3.4 ASSIGNING TASKS TO A PROCESSOR QUEUE 


As mentioned above, each task in the Model 3200MPS System is 
associated with an LPU. The initial LPU value is established at 
task link editing time to be either LPU=0 by default or a value 
specified in the OPTION LPU command of Link. The LPU value may 
be changed at task load time or whenever the task is paused via 
a corresponding SVC6 function or with an operator OPTION LPU 
command. 


Each task's LPU mapping (association with an APU queue) is 
enabled or disabled in a task status either by default or viaa 
corresponding SVC6 function or via operator OPTION LPU and OPTION 
NLPU commands. By default, LPU mapping is disabled if the task 
is linked with LPU=0 and is enabled if the task is linked with a 
non-zero LPU. The operator OPTION LPU command, however, sets the 
specified LPU and also enables mapping even if LPU=0 was 
previously specified. The operator OPTION NLPU command enables 
mapping without changing the LPU number. 


All tasks with mapping enabled are called LPU-directed tasks. 
OS/32 places the LPU-directed tasks onto corresponding APU 
queues. Tasks with mapping disabled and CPU-directed tasks are 
placed onto the CPU ready queue. 
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* * 
x This example loads and starts a copy of a task x 
* and makes it LPU-directed via the SVC6 function. * 
x * 


JOR III IIR IO IKI IO IOI IO IOI IC IO OI IO III OI IOI OI OI IO IOI IO ik 


$SVC6 

ALIGN 4 ; 
PARBLK DS SVC6 ALLOCATE STORAGE FOR PARBLK 
ENDBUK EQU 7 
*SET LOAD, ASSIGN LPU, LPU-DIRECTED, & START FUNC CODES 

ORG PARBLK+SVC6 .FUN 

DC SFUN .DOM!SFUN.LM!SFUN.LPM!SFUN.XLM!SFUN.SIM 

ORG PARBLK+SVCb6 .LU 


DB 5 LU OF DIRECTED.TSK (IMAGE) 
ORG PARBLK+SVC6.SAD 
DC 0 TASK EXECUTION START ADDR 
ORG PARBLK+SVC6 .SOP 
DC 0 START OPTIONS (none) 
ORG PARBLK+SVC6 .SEG 
DC ¥'40' TASK WORKSPACE 
ORG ENDBLK 
START EQU x 
*SETUP NAME OF TASK TO BE LOADED 
LI R1,C'APU1' 
ST Rl, PARBLK 
LI R1,C'TASK' 
ST R1, PARBLK+4 
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*ASSIGN LPU NUMBER 
LIS R1,2 
STB Rl, PARBLK+SVCb6.LPU 
* ISSUE SVC6 TO LOAD TASK FROM LU5 
SVC 6, PARBLK 
END START 


After the SVC6 in the above example is executed, the task will be 
loaded into memory from the file (DIRECTED.TSK) with a workspace 
of 64 (X'40') bytes. When the task is started, the task manager 
dispatches it to the APU queuve into which LPU2 is mapped. 


3.5 CONTROLLING TASK ORDER OF EXECUTION 


In a uniprocessor system, priority scheduling determines the 
execution flow of the tasks in the system. In order to affect 
task scheduling, a programmer must change the priority of the 
tasks in the system. In an O0S/32 Model 3200MPS multiprocessing 
system, there is a choice of possibilities to control the order 
of task execution as described in this section. 


3.5.1 Changing Auxiliary Processing Unit (APU) Task Queue 
Ordering 


Each of the APU queues can be set to handle its assigned tasks 
through the following priority disciplines. 


e The no-priority queue services tasks in a_ first-in/first-out 
(FIFO) order, regardless of task priority. 


e The priority queue services its highest priority tasks first 
and its equal priority tasks in a FIFO order. No preemption 
of currently executing tasks by higher priority tasks will 
occur. 


e The priority-enforced queue services its tasks in the same 
manner as the priority queue; however, higher priority tasks 
are allowed to preempt lower priority tasks being executed on 
the processor assigned to the queue. 


At operating system load time, the queues are initially set with 
the following priority assignments or disciplines. See Table 
Sa Lic 
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TABLE 3-1 QUEUE PRIORITY ASSIGNMENTS 


H QUEUE |} PRIORITY DISCIPLINE 
fo SSS Sf SS aoe Se 2 SS SS SS SS Se SSS SS SSS 
| CPU Ready Queve | Priority-enforced 

|} APU Queue O | Priority-enforced 

| APU Queue 1 to n} No-priority 


ee ee mee cree ie ee rem cme ne en ts me ct ce es sh nt me mt me eee ee ee ee ee ee ce ee 


These initial settings can be subsequently altered via a 
corresponding SVC13 mapping function or with an operator QUEUE 
command . 


FOKKER koko kok 


* The following example uses SVC13 to change a x 
is queue priority discipline. If the discipline * 
= of this queue prior to the SVC13 call was no- * 
7 priority, OS/32 will reorder the queue according * 
bs to the task priorities subsequent to the SVC13 = 
* call. A task incorporating this code must be * 
x * 
* x 


linked using the LINK command OPTION APMAPPING. 
L222 eee tees eeere sees eee etree eeseseeeeeeeeeeeeeeeeeeeere ene eee 2 2&3 


Example: 
SVvC13 
ALIGN 4 
DISCIP DS SvC13 ALLOCATE STORAGE FOR SVC13 PARBLK 
SETD EQU * 


*GAIN MAPPING RIGHTS, SET QUEUE DISCIPLINE, 
*RELEASE MAPPING RIGHTS 
ORG DISCIP+SVC13.OPT 


DB x'85' 

ORG DISCIP+SVC13 .FUN 

DB 2 FUNCTION CODE=2 

ORG DISCIP+SVC13.APN 

DB 3 QUEUE NUMBER 

ORG DISCIP+SVC13.USE 

DC H'1' PRIORITY DISCIPLINE 
ORG SETD 


*ISSUE SVC13 TO CHANGE QUEUE DISCIPLINE 
SVC13, DISCIP 
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3.5.2 Monitoring and Preempting Auxiliary Processing Unit 
(APU) Task Execution 


The Model 3200MPS System provides facilities to monitor APU 
operation via the mechanism of task trap service. The APU 
reports its significant events to 0S/32 by issuing asynchronous 
status signals. 


An APU status signal is a byte with the following format: 


1 PAR | RUN |} NON- { WAIT | RESP | ERROR | MOD1 { MOD2 | 


ee ee ee ce ee ee ee ee re et ee ee ee se ee ee ee ee i me Se ee Se we ee ee ee ee ee a ee aoe et oe ee me ee ee meme 


PAR is the parity bit which is adjusted to 
maintain odd parity for the byte. 


RUN is set to 1 if the APU is currently not idle. 
The APU may be executing task instructions or 
performing servicing functions (nontask) such 
as: selecting a task from the queue, 
releasing a task back to the queue, processing 
a task fault, etc. 


NON-TASK is set to 1 if the APU is performing any of 
the servicing functions. 


WAIT is set to 1 if the APU is idle and in the wait 
state imposed upon it by the last executed 
task. 


RESP is set to 1 if the APU is returning the status 
in response to a command from the CPU 
(normally an SVC13 read APU status function); 
this bit is always reset in an APU 
asynchronous status signal. 


ERROR is set to 1 if the APU has detected an error 
in system data structures and subsequently 
entered an idle state. 


MOD1, MOD2 are set or reset to supply some additional 
status information. 
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When the last three bits are set to 1, they have the values of 4, 
2 and 1, respectively. The actual value of these three bits 
reflects the APU status condition as follows: 


Undef ined. 


The APU has detected that the queue to which 
it is assigned is empty (contains no tasks). 


The APU has rescheduled (released) a task to 
the APU queve as ae result of an RSCHL 
instruction in the task or as a result of an 
appropriate command issued via an SVC13 
control function. 


The APU has rescheduled a task to the CPU 
ready queue as a result of an RSCH O 
instruction in the task, an appropriate 
command issued via an SVC13 control function, 
a nonexecutable APU instruction (normally an 
SVC), or a task fault. 


The APU has detected an error in data 
structures at an arbitrary moment. 


The APU has detected an error in data 
structures while attempting to select a task 
from its queue. 


The APU has detected an error in data 
structures while attempting to lock its queue. 
Each processor locks its assigned queue prior 
to manipulating it. 


Undefined. 


Detailed information regarding the data structure errors detected 
by the APU can be obtained using SVC13 read APU status function. 


In 


NOTE 


‘absence of an APU monitor task, 


$/32 reports APU errors via the operator 
console. 


This section will examine the methods used by an APU monitor task 


to: 


@ receive status signals from an APU, and 


@® preempt the current task executing on an APU with another task 
after a certain time interval has elapsed. 
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To receive a status signal from an APU, the APU must be connected 
and thawed (via SVC6) as a trap-generating device to the monitor 
task. In addition, the monitor task must have the appropriate 
bits in its task status word (TSW) set, a task queue to receive 
the status signal, and a task queue trap-handling routine to 
service the trap. 
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- The following example demonstrates how to code * 
- a typical APU monitor program to receive and * 
. handle task queue traps from an APU. For more 7 
7 information on task trap handling, see the 0S/32 * 
* x 
x x 


Application Level Programmer Reference Manual. 
SOI OOO IOI III OI IOI OI OIG OI IOI IOI IOI OI ICICI I IOC IO IOI III IOI IO IO 


Example: 


xxk*x Define a task queue to receive APU signals  ***XXRKKKEKKKE 


x x 
ALIGN 4 : 
TASKQ DLIST 100 DEFINE TASK Q OF 100 ELEMENTS. 
x x 
* Put the address of task queue in UDL (UDL.TSKQ) * 
x x 


LA R14, TASKQ 
ST R14, UDL.TSKQ 


* x 
* Set TSW bits to enable the applicable task traps. * 
x x 
LI R14, TSW. TSKM+TSW.APTM 
x x 
* TSW.TSKM enables task queue service traps 7 
* TSW.APTM enables signals from APU * 
x Save TSW values to enable APU signals and task Q entries * 
st R14,ENTRIES SAVE TSW VALUES 
* TO ENABLE APU SIGNALS AND TASK Q ENTRIES 
x * 
* SET UP TSW FOR TRAPS IN UDL x 
x x 
LA R15,QSERVICE 
STM R14,UDL.TSKN SET UP TSW ON TRAPS IN UDL 
svc 9 ENABLE TASK QUEUE ENTRIES 
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For information on writing a task queue trap handling routine 
that removes the APU status entries from the task queue, see the 
0S/32 Application Level Programmer Reference Manual. 
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* The following code demonstrates a method of x 
* connecting the APUs as trap-generating devices 7 
x to the APU monitor task. * 
L222 oe. eee ee eee SSeS eset eeeeeeeee reese eee e se ceeeeeeeercereerceen se a 2 3 


Example: 


Enable each APU in the system if it is not enabled and then * 
connect to each APU, but first * 
read APU assignment information to obtain the - 
x 
x 


% & HB HM 


number of APUs in the system. 


START SVC 13 ,APUASGN 
LB Rl, BUFFER1+1 LOAD MAX APU NO.INTO R1 
* SET UP SVC 13 PARAMETER BLOCK TO by 
* FETCH APU STATUS 7 
Lis R3,X'80' 
STB R3,FETAPU+SV13.0PT SET APU STATUS OPTION 


Lis R3,1 

STB R3,FETAPU+SV13.FUN SET UP FUNCTION CODE 1 

LA R4,APUBUF * 
st R4,FETAPU+SV13.BUF SET UP BUFFER ADDR. * 


LHI R3, 40 
STH R3,FETAPU+SV13.LEN SET UP BUFFER LENGTH 


x x 
* SET UP SVC13 PARAMETER BLOCK TO ENABLE THE APU * 
* , x 

LIS  R3,3 SET UP SVC 13 FUNC CODE 3 

STB R3,ENABAPU+SV13.FUN 

LIS  R3,X'Cl' SET UP CONTROL OPTIONS 


STB R3, ENABAPU+SV13 .OPT GAIN, ENABLE, RELEASE 


GET THE APU STATUS. IF APU IS DISABLED, 
ATTEMPT TO ENABLE IT. IF APU CAN'T BE 
ENABLED, LOG MESSAGE TO CONSOLE AND 
CONNECT TO IT ANYWAY JUST IN CASE IT IS 
ENABLED LATER. 


e 4% Oe He HO 
e h % MH Oe 


APULOOP EQU *- 
* GET APU STATUS 
STB R1,FETAPU+SV13.APN SET UP APU NO. 


SVC 13 ,FETAPU ISSUE SVC 13 

LH R4,FETAPU+SV13.ERR GET SVC 13 ERROR STATUS 

BZ GETSTAT IF NO ERROR-GET APU STATUS 
BNE ER.ROUTE IF ERROR, BRANCH TO ER.ROUTE 
LB R5,APUBUF +5 GET 2ND BYTE OF APU S-STATUS 
BNZ CONNECT NOT DISABLED, GO CONNECT 


48-040 FOO RO3 3-13 


*APU IS DISABLED; ISSUE SVC 13 TO ENABLE IT. 
STB R1,ENABAPU+SV13.APU SAVE APU NUMBER 
svc 13 , ENABAPU ENABLE THE APU 


LH R3,ENABAPU+SV13.ERR GET SVC 13 ERROR STATUS 
BNZ  ENAB.ERR BRANCH TO ERROR ROUTINE ON ERROR 
CONNECT EQU * 
x * 
*SAVE APU NO. AS PART OF APU'S TGD MNEMONIC x 
STB R1,SVC6.DEV 
ISSUE SVC6 TO CONNECT AND THAW THE APU * 
* x 
SVC 6,APUTRAPS 
LH R6,SVC6.STA GET SVC 6 ERROR STATUS 
BZ NEXT. APU NO ERROR-GO CONNECT TO NEXT 
* APU 
STB R1,CONB.ERR+24 SAVE APU NO. IN MESSAGE 
svc 2,LOGMSG LOG MESSAGE: COULD NOT 
x CONNECT TO APUX 
NEXT.APU SIS Rl,1l MOVE ON TO NEXT LOWEST APU NO. 
BP APULOOP GO HANDLE NEXT APU. 


The parameter blocks used in the above example are defined as 


follows: 


*SVC 13 Read APU Assignment Parameter Block and Buffer 


ALIGN 4 
APUASGN DS SVvC13 
ENDPBK EQU x 


ORG APUASGN+SV13 . FUN 
DB x'oo' SET FUNC CODE 0 
ORG APUASGN+SV13 . BUF 


x 


DAC BUFFER 1 DATA BUFFER ADDR 
ORG APUASGN+SV13.LEN 
DC H'50' MAX LENGTH OF BUFF 
ORG ENDPBK 
ALIGN 4 

BUFFER DS 50 

x 

* §VC13 Fetch APU Status Parameter Block & Buffer 

- ALIGN 4 

* FETAPU DS Svcl13 
ALIGN 4 

APUBUF DS 40 

* 


*k* SVC1L3 Enable APU Parameter Block 
x 


ALIGN 4 
ENABAPU DS SvC13. 
* 


* SVC 6 Connect & Thaw APU Parameter Block 
*% 


$SVC6 
ALIGN 4 


* 
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APUTRAPS DS SVC6. 
ENDAPUTB EQU * 
ORG APUTRAPS+SVC6.FUN 
Ds y¥'cooo cooo' SVC6 FUNC CODE- 
* SELF-DIRECTED, CONNECT & THAW 


ORG APUTRAPS+SVC6. DEV 
DC C'APU' TRAP-GENERATING DEVICE MNEMONIC 


ORG ENDAPUTB 
* 


****k SVC 2 Log Message Parameter Block 
* 


LOGMSG DB 0,7 

DCcz CONE .ERR-CONB . ERR 
CONB .ERR DB C'UNABLE TO CONNECT TO APU' 
CONE .ERR EQU i 


The code in the above example allows the monitor to receive traps 
from the APUs. Status returned from these traps can be reported 
to the console (via SVCl or SVC2 code 7) or to a file designated 
for the APU output (via SVCl). In addition, this monitor program 
can be coded to run a certain task (TASK1) every ten minutes’) on 
a specific APU. To do this, the monitor sets an interval timer 
via SVC2 code 23. Upon expiration of the timer, the monitor task 
issues an SVC13 code 3 to preempt the current executing task on 
the APU, as_ shown below. This preemption mechanism is only 
allowed on no-priority queues. It is used when the _ overhead 
associated with maintaining a priority queue is to be avoided. 


Example: 
svc 13,PREQ 
ALIGN 4 
* PREEMPT TASK EXECUTION, RESTART APU 
PREQ.OPT DB X'BS' SET SVC 13 OPTIONS: 
PREQ.FUN DB x'03' SET FUNCTION CODE- 
* CONTROL FUNCTION 
PREQ.DOP DB X'ol' DIRECTIVE OPTION-— 
* START APU 
PREQ.APN DB X'Ol' APU NO. - APU 1 
PREQ.APS DS 2 APU HARDWARE STATUS 
PREQ.ERR DS 2 SVC 13 ERROR STATUS 
PREQ.BUF DAC BUF2 DATA BUFFER ADDRESS 
PREQ.USE DS 2 LENGTH OF BUFFER USED 
PREQ.LEN DC H'8' MAX LENGTH OF BUFFER 
ALIGN 4 
BUF 2 pc C'TASK1 ppy' TASK ID BUFFER 
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Execution of the above SVC13 will cause the monitor to gain 
control rights to the specified APU (APU1), provided that the 
task has been link-edited with the APCONTROL task option and no 
other task has control rights to the APU. The control options, 
specified in the SVC13 parameter block, will then cause the 
following actions: 


e Execution of the current executing task on the APU will be 
stopped. 


@ The current task will be rescheduled to the end of the APU 
queue. 


e The APU's queue pointer will be repositioned to point to 
TASK1. (This will cause TASK1 to be selected as the next task 
to be executed on the APU.) 

e The APU will be restarted for execution of TASK1. 

@ The monitor task will release the control rights to the APU. 


The remaining code in the monitor program should check the 
PREQ.ERR field of the PREQ parameter block for errors as follows. 


Example: 


LH R2,SV13.ERR 
BNZ ERR. PREQO 


If an error has occurred, ERR.PREQ can log a message to the 
console. 


Finally, to reexecute TASK1 in ten minutes, the interval timer 
(via SVC2 code 23) should be reset so that the SVC13 code 3 to 
preempt the current APU task can be reissued when ten minutes 
have elapsed. 


See the 0S/32 Supervisor Call (SVC) Reference Manual for more 
information on SVC13, SVC6 and SVC2 code 23. 
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3.5.3 Transferring a Task from an Auxiliary Processing Unit 
(APU) to the Central Processing Unit (CPU) 


Under certain conditions, a monitor task may need to transfer 
some other task back to the CPU ready queue. The task to be 
transferred may be executing on an APU or waiting on its queue. 
The monitor task can transfer a task back to the CPU ready queue 
by issuing an SVC6, specifying the following function codes: 


@ Suspend (SFUN.SM) 

e Transfer to CPU (SFUN.XCM) 

® Release (SFUN.RM) 

The suspend will transfer the task back to the CPU ready queue, 
and then the LPU-directed task status is reset. Upon release, 


the task will stay on the CPU ready queue and not be dispatched 
according to its LPU assignment. 


Example: 
svc 6,CPUDIR 
ALIGN 4 
$SVC6 
CPUDIR DS SVC6. 


CPUDIRE EQU- * 
ORG CPUDIR+SVC6.ID 
Dc C'TASK1 bpp ' ID OF TASK TO BE 
* TRANSFERRED 
ORG CPUDIR+SVC6.FUN 
* SET OTHER-DIRECTED, SUSPEND, TRANSFER TO CPU, & RELEASE FUNC CODES 
* FOR TASK] 
DB SFUN.DOM!SFUN.SM!SFUN.XCM!SFUN. RM 
ORG CPUDIRE 


Execution of this SVC6 causes TASK] to be suspended (if it is not. 
already in a wait state) and transferred to the CPU ready queue. 
Resetting the LPU-directed status directs the task manager to 
ignore its LPU mapping and to schedule this task for execution on 
the CPU ready queue. When released, the task will execute on the 
CPU at the location following the instruction that was executed 
before the task was suspended. If the SVC6 in the above example 
did not reset the LPU-directed status bit, the task will again be 
dispatched to the APU queue into which its LPU is mapped upon 
release from the suspended state. 
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3.5.4 Internal Task Control of Auxiliary Processing Unit (APU) 
Execution 


A task can exercise control over its own execution on an APU 
through the SVC6 mechanism described above since SVC6 can be made 
self-directed; however, there are more efficient mechanisms 
achieving the same result that are particulary valuable for 
real-time and APU diagnostic applications. 


1. A task wishing to relinquish use of an APU while remaining on 
the same processor queue may issue the following instruction: 


RSCH R1,1 


The APU places the task at the queue tail and immediately 
picks up the task residing at the queue head. 0S/32 will 
restore the queue order according to the queue discipline, if 
necessary. 


2. A task wishing to transfer to the CPU indefinitely, may issue 
the following instruction: 


RSCH R1,0 


The APU sends the task to the CPU and then immediately picks 
up the task residing at its queue head. 0OS/32 resets the 
tasks LPU-directed status, which prevents the task from going 
anywhere but the CPU receive queue. 


3. A task wishing to transfer to an APU indefinitely, according 
to its LPU mapping, may issue the following instruction: 


RSCH R1,2 


OS/32 insures that the task is scheduled to the appropriate 
APU queue according to the task's priority and the queue 
discipline. 


4. A task may manipulate its TSW CPU-override status to enable 
or disable its transfer to the APU, for a given reason, to 
which the TSW corresponds. Bit TSW.CPOB (currently bit 8) 
prevents task scheduling to an APU queue when set to l. This 
is necessary when a particular task fault, not a single 
instruction, should be executed on the APU. 


3-18 48-040 FOO RO3 


3.5.5 Verifying Task Transfer to an Auxiliary Processing Unit 
(APU) 


It may be necessary for a task to verify whether or not it has 
actually been transferred to an APU queue. For example, suppose 
a task on the CPU is assigned to LPU3 and executes the following 
instruction: 


RSCH R1,2 


Execution of this instruction will cause OS/32 to set the 
LPU-directed status of the task. The OS/32 task manager will 
then attempt to transfer the task to the APU queue into which 
LPU3 has been mapped. Suppose LPU3 is mapped to APU queue 3 and 
APU4 is assigned to this queue. To verify that the task is 
indeed executing on APU4, the next instructions executed by the 
task could be: 


LIS R1,0 GET RTSM PULSE LINE 
* TO PULSE 

LI R2,15 FILL IN APU ID 

STIG R1,R2 GENERATE SIGNAL 


* HERE THE NO. (15) CAN NEVER MATCH 
THE APU [D IN THE RTSM. NO SIGNAL WILL BE 
* SENT. INSTEAD, ONLY THE APU [ID IS RETURNED TO RL 


* 


After execution of GSIG, Rl will contain the number of the APU 
that the task is currently executing. See the Model 3200MPS 
System Instruction Set Reference Manual for more information on 
the RSCH and GSIG instructions. 


3.5.6 Customizing Auxiliary Processing Unit (APU) Fault and 
Supervisor Call (SVC) Handling — 


0S/32 allows customization of fault and SVC handling by the APUs. 
When consistently pursued, this route may allow reduction of the 
task traffic between the APUs and the CPU caused by SVCs, or it 
may provide for APU I/O handling, "invisible" to OS/32, and 
subsequently more efficient. 


As an example of this customized handling, an APU can be made to 
wait for a task return while the task fault or SVC is processed 
by the CPU. This may be needed to leave private queue orders 
undisturbed by occasional SVCs. 


This feature is not fully supported by OS/32 and, therefore, is 


intentionally made difficult to use. However, software tools may 
be easily developed to exploit the customization feature. 
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In order to allow for custom processing of the faults and SVCs in 
a given task by the APUs, the following actions must be 
performed: 


@ An APU trap block has to be allocated in memory. This block 
will contain pairs of fullwords, each being a program status 
word (PSW) for a given APU detected reason in this order: 


- arithmetic fault 

- illegal instruction 

- memory controller fault 

- instruction format fault 
- svc 

- machine malfunction fault 


@e A single trap block is allocated during 08/32 system 
generation (sysgen) and is designated in the map under a 
symbol TBLK1. Any additional blocks can be allocated using 
the MODULE command at sysgen. 


@ The trap block has to be patched with zeros for various 


reasons. If an APU wait is desired, the first word of the 
pair is set to X'8000' (bit 16 set). The second word does not 
matter. If custom processing is desired, the first word of 


the pair is set to the required status and the second word is 
set to the location where the custom processing begins. 


@ The APU queue parameter block (QPB) fullword at location 
QPB.TPTR, (currently xX'8' in QPB) has to be patched to the 
address of the APU trap block after task loading. This 
patching can be performed using the operator MODIFY command or 
via a dedicated e-task assembled with the appropriate data 
structures. 


When a task executes on an APU assigned to the patched queue, and 
a fault is detected for which the PSW in the trap block is not 
zero, the APU transfers control according to this PSW. In the 
case of the bit 16 of the first word set in PSW, the APU 
transfers the task to the CPU ready queve and awaits the task's 
return. OS/32 will restart the APU when the task is scheduled 
back to it. 0OS/32 also restarts the APU when the task for which 
the APU is waiting is cancelled or terminated. 


If the customized processing needs to be done on a per task 
rather than per queue basis, this can be arranged by patching out 
the OS/32 code in module APSV routine TMCKAPU that loads the 
QPB.TPTR into every task control block (TCB) scheduled to the 
queue. Then, instead of patching QPB.TPTR with the selected 
task's TCB at location TCB.TPTR (currently X'20' in TCB), it can 
be patched with the address of the trap block. 
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3.6 PREVENTING MEMORY ACCESS CONFLICTS 


When several processors are executing simultaneously, it is 
possible for tasks running on two or more processors to require 
access to the same data. For example, suppose two tasks share a 
buffer list consisting of 30 buffers defined as follows: 


BLISTBIT DS 2 
BUFLIST DLIST 30 


BUFLIST contains the addresses of the buffers. BUFLIST, and the 
actual buffers, reside in an area of memory shared by the two 
tasks. One task collects data, writes it to a buffer and adds 
the address of that buffer to the bottom of the list. The other 
task removes an address of a buffer from the top of the list and 
processes it. Since both tasks in a Model 3200MPS System can be 
run simultaneously on different APUs, both tasks may attempt to 
access the list at the same time. The Test and Set instruction 
(TS) can be used to ensure that only one task at a time can 
access the buffer. 


To ensure that only one task at a time can access BUFLIST, a test 
and set operation is performed on BLISTBIT. BLISTBIT acts as a 
lock-out mechanism that is set and reset. A task can only access 
BUFLIST if BLISTBIT is not set. 


3.6.1 Avoiding System Deadlock 


When using the test and set operation, care should be taken to 
ensure that system deadlock is avoided. 


For example, suppose task A uses TS to lock out data structure xX 
while task 8B is locking out data structure Y. Task A now finds 
that it needs to access data structure Y, so it waits for Y to be 
released. Similarly, Task B finds it needs to access data 
structure xX, so it waits for X to be released. Since each task 
holds the data structure needed by the other, processing stops. 
Both tasks are deadlocked. 


To avoid system deadlock, the Test and Set instruction should be 
used with a time-out mechanism. 


Se See eS eee ere eee eee eeeseeese se eeeeeeeceeerc eee ee ec eeceeeereeeeeeres ss 3 


* The following example shows how to prevent * 


* memory access conflicts without system deadlock. 7 
Loe tee eee ee ee eee Se ee eee Stee eee reese eeeereeeeese secre sere eeseeeeeee ee] 
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Example: 


TS BLISTBIT TASK CHECKS IF IT CAN GET 
* ACCESS TO LIST 

BNM CONTINUE PROCESS LIST IF FREE 

LI R2,50 LOAD TIMEOUT VALUE OF 50 
* MICROSEC IN R2 
SETBITLP EQU * TIMER ROUTINE 

SIS R2,1 DECREMENT TIMEOUT COUNT 

BM TIMEOUT BRANCH TO TIMEOUT ROUTINE 
*IF BRANCH TO TIMEOUT IS TAKEN IT MEANS THAT THE x 
*TASK STILL COULD NOT GET ACCESS TO LIST * 
*THE TIMEOUT ROUTINE PRINTS A MESSAGE TO THE CONSOLE x 
*SO OPERATOR CAN TAKE NECESSARY ACTION * 
*ELSE CONTINUE x 

LH R4,BLISTBIT USE APU CACHE TO MATCH LOCKS 

BMS SETBITLP BUFLIST NOT AVAILABLE YET; 
x TRY AGAIN 

TS BLISTBIT BUFLIST IS AVAILABLE SO 
x ATTEMPT TO GRAB ACCESS 

BMS SETBITLP NOT QUICK ENOUGH, RETRY 
x*IF SUCCESSFUL, PROCESS LIST x% 
x x 
CONTINUE EQU) * 
* F * 
* : * 
x : * 
*ACCESS BUFLIST EITHER BY ABL (ADD TO BOTTOM OF LIST * 
*INSTRUCTION) OR RTL (REMOVE FROM TOP OF LIST INSTRUCTION) . * 
x * 
x ; * 
x ‘ x 
*AFTER PROCESSING BUFFER, UNLOCK BLISTBIT SO OTHER TASK CAN x 
xACCESS IT. * 
x x 


LIS R4,0 
RBT R4,BLISTBIT 


3.7 MEASURING REAL-TIME PERFORMANCE ON A MODEL 3200MPS SYSTEM 


The OS/32 system macro library provides a set of timer macros 
that can be used to measure the real-time performance of 
individual tasks running in a Model 3200MPS System. These macros 
allow the programmer to set up a named timer in memory. A named 
timer can be compared to a stopwatch that measures the amount of 
time elapsed from the time the watch is started to the time it is 
stopped. The following example shows the data structure setup in 
memory for a timer named TIMRNAME. The timer macro, CRTIMERS, is 
used to set up timer data areas. 
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Example: 


ALIGN 4 
TIMRNAME DCF C'TIMRNAME' TIMER NAME (8 CHAR MAX) 
DCF 0 TIMER COUNTER 
DCF 0 TIMER START VALUE 
DCF 0 ACCUMULATED TIME 
DCF 0 REGISTER SAVE AREA 


The timer macros are used to set the watch and read the 
accumulated time after a specified interval has elapsed. The 
timer macros are listed in Table 3-2. 


TABLE 3-2 TIMER MACROS 


MACRO i FUNCTION 


ee ee ee ee ek ES ee Ee OE Ee ee Se ee ee ee ee ST ee 2 ee ee 2? 2? ? Sd St Shek St . tk) 


CRTIMERS (NAME1[,NAME2,...]) |} Creates a data area for each 
i named timer. 


i Gets the total time accumulated 
| by the named timer. 


ee rm me ee ci cm ee ee ae es ee ee ree ee eee ee ee eee ee ee ee ee ee ee ees es ee es ee 


| Gets the number of intervals 
i that have been timed by this 
; timer. 


FOI III III IOI IOI IO IOI IOI IOI OIG IIR III II III III III IOI 


x The following example demonstrates how these x 
x macros can be used to time the execution of a 7 
* program and its subroutine. = 


JOIST IOI III IOI aOR air 
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Example: 


* Create a data area for the timer 
* for MAIN and the timer for SUB 
x 


CRTIMERS (MAIN,SUB) 
* 


* Start timer for MAIN. 

x 

START EQU x 
STRTIME MAIN 


. 


BAL R15 ,SUBPROG 


* Stop timer for MAIN 
STOPTIME MAIN 
A * Get total time accumulated by MAIN 
* Timer. Load into REG 0 
GETIME MAIN,RO 


* Log MAIN program execution time. 


* Get total time accumulated by SUB 
* timer. Load into REG 3 
GETIME SUB,R3 
Get number of intervals timed by 
* SUB timer. Load into RO 
READTCNT SUB,RO 


* 


* 


Compute average subroutine execution 
* time. 
DR R2,RO 


SUBPROG EQU x 

x 

* Start timer for SUB 
* 


STRTIME SUB 


x 
* Stop timer for SUB 
x 


STOPTIME SUB 
BR R15 


Detailed descriptions of the timer macros can be 
08/32 System Macro Library Reference Manual. 
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ee He 


ee HH HH HH 


* 


ee HM 


found in the 


48-040 FOO RO3 


3.8 WHERE TO GO FOR MORE INFORMATION 


This chapter is intended to demonstrate assembly language 
programming techniques used in designing system level control 
programs that take advantage of the Model 3200MPS System 
multiprocessing capabilities. However, all the programming 
facilities avallable for writing system level control programs 
are not shown. Table 3-3 summarizes additional facilities and 
lists the manuals in which they are described. 


TABLE 3-3 ADDITIONAL INFORMATION SOURCES FOR 
MODEL 3200MPS SYSTEM PROGRAMMING 


| MANUAL H PROGRAMMING METHODS DESCRIBED H 
H SS SSS SS SSS SSS SS SS SSS SSSI SSSA SSS SES SS SSS TS SES SC SSCS SS SSS SV VS ST SS ST : 
| Model 3200MPS System i Describes the machine instructions } 
} Instruction Set | specific to the Model 3200MPS System |; 
| Reference Manual {| processor. Also gives a detailed | 
| | discussion of the APU processor | 
H | states. | 
‘ 1 

i) 


i OS/32 Run-Time Library | Describes the Perkin-Elmer FORTRAN } 
i} (RTL) Subroutines and {| VII RTL routines’ available for | 
i Intrinsics Reference } writing a FORTRAN system level | 
| Manual i control program that performs’ the | 
| | functions described in this chapter. } 
i) i 
4 


ce eciceeeciieneticaneicciendinemtanneDemeeteeane tea Meee tc eae tt ee eI ee ee en en ra On Onan we nO ORE a eee ed 


0S/32 Operator 
Reference Manual 


| Describes the operator commands that |} 
} can be used to perform SVC13 mapping | 
} and control functions. APU related } 
} functions included APC, LPU, OPTION } 
| LPU, QUEUE. | 
‘i 


| OS/32 Supervisor Call {| Gives details on how to use SVC6, | 
i (SVC) Reference Manual {| SVC13 and assembly language program- | 
i ( 1 
' 1 ! 
i 1 


ming SVCs. 
SS a aia ae ea eas Bl RI lee al aes | 
i OS/32 System Macro i Describes the time and Ssvcl3 | 
i Library Reference { macros. | 
{ Manual | H 
( 


' 
OS/32 Link Reference } Describes the use SE OPTION L.PU, | 
Manual } APCONTROL and APMAPPING at task | 

{| linkage time. { 

Met eae ees oe Sn a ES a ns re en es es a a a rN ey isTnes' ust bes lacs “otitis eres teen st tee ' 

| OS/32 Application | Gives details on writing a task trap | 

} Level Programmer i handling routine that can be used to ; 

| Reference Manual } handle APU-related events. { 

a a a a a a aa a a a a a aca H 

{| OS/32 System | Describes the use of the MODULE } 

i Generation (Sysgen/32) {| command. i 

{| Reference Manual ' H 


re eae rs mc a em ee ies en me ee ee ee ee nee me ee ee ee ee ee ee ee ee ee me ee ee me ee ee 
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CHAPTER 4 
SUPERVISOR CALL (SVC) INTERCEPTION 


4.1 INTRODUCTION 


SVC interception software is used to write programs that can 
emulate the SVC processing ability of 0OS/32. This software 
consists of macros that allow a task (intercepting task) to 
intercept the SVC of another task before it goes to the operating 
system for processing. Once intercepted, the SVC can be 
monitored by the intercepting task and sent to the operating 
system for processing, or it can be processed by the intercepting 
task. Table 4-1 lists the system macros used for SVC 
interception. 


TABLE 4-1 SYSTEM MACROS FOR SVC INTERCEPTION 


a ee re merm mee mre nme eee eee mm cm en tte ee te ce ee ee ee ee ee ee ee ee ee ee 


MACRO | FUNCTION 


SVM EMSS SS SERRE SST ESS LSS SSG I RRR TRESS SMBS CK ER SBE ES SS ese Ss = 


ICREATE {| Creates an SVC intercept path. 


macros and branches execution to specific error 
routines within the intercepting task. 


ee ne re ae ee ae as re ee nn es re ce a a a er ee ee ee ee en ee ee ee ee ee ee ee ee ee 


| H 
i i 
i i i 
i i 
| IREMOVE {| Removes a previously created path. H 
| i i 
| IGET ; Gets data from a data area of the task that issued | 
| | an intercepted SVC. i 
i i i 
} IPUT ; Puts data into a data area of the task that issued } 
| | an intercepted SVC. H 
| | i 
i ICONT i} Continues standard execution of an intercepted SVC } 
| i by passing control to an 0OS/32 SVC executor. i 
t F i i) 
t i é i) 
| IPROCEED {| Allows the task that issued the intercepted SVC to |} 
| {| proceed with its execution. H 
' { t 
! 1 i 
| IROLL {| Makes an intercepted task rollable. H 
! i] 1 
' i I 
i ITERM i Terminates an intercepted SVC after processing. i 
i) ! i] 
i] 1 i) 
| ITRAP ; Sends a task queue trap to a task. i 
' i] i] 
1 4 1 
i IERRTST | Evaluates errors returned by any of the above i 
I 1 i 
i | i 
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The intercepting task tells the O0S/32 SVC executor which SVC it 
will process or monitor. When the intercepting task is sent an 
Svc from the executor, the intercepting task handles’ the 
intercepted SVC while the task that issued the SVC is placed in 
a wait state. While executing the intercepted SVC, the 
intercepting task can read from or write to the address space of 
the task that issued the SVC. 


A task is not aware that its SVC has been intercepted unless it 
is informed by the intercepting task. 


SVC interception software must be configured in OS/32 at the time 
of system generation (sysgen). See the INTERCEPT configuration 
statement in the 0OS/32 System Generation (Sysgen/32) Reference 
Manual. 


A task can intercept SVC calls only after it is linked with the 
intercept task option enabled (OPTION INTERCEPT). See the 0S/32 
Link Reference Manual. The task can then be programmed to 
intercept any of the following SVCs issued by any application 
task in the system: 


e svclL 


e SVC2 code 7 


e svc3 
e svC6 
e svc7 


Intercepting tasks can be loaded and executed under the 


multi-terminal monitor (MTM). However, the intercepting task 
must be loaded from an account that has executive task (e-task) 
load privileges. See the OS/32 Multi-Terminal Monitor (MTM) 


System Planning and Operation Reference Manual. 


4.2 HOW SUPERVISOR CALL (SVC) INTERCEPTION WORKS 
In general, SVC interception software functions as follows: 


1. A task with SVC interception enabled by Link is built. This 
intercepting task must: 


@® reserve memory for a set of request descriptor block (RDB) 
buffers for each SVC to be intercepted, 


e build a circular list for storing addresses of RDB buffers 
containing information on intercepted SVCs, , 
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@e create, via the ICREATE macro, intercept paths that 
designate the SVCs to be intercepted, and 


e define, via the ICREATE macro, what control the 
intercepting task has over the SVCs it intercepts. 


An application task issues an SVC. 


If no intercept path was created for that particular SVC, one 
of the standard OS/32 executors services the SVC. 


If an intercept path has been created for that SVC, the 
operating system: 


@ intercepts the SVC before it reaches the OS/32 executor, 


® removes an RDB address from the circular list of the 
intercepting task, 


@ loads’ the SVC's parameter block and identifying 
information into the RDB, and 


@e sends a task event trap to the intercepting task to notify 
the task that an SVC has been intercepted. 


Execution of the intercepting task branches to the task event 
trap-handling routine. The address of this routine is 
specified when the path is created via the ICREATE macro. 


If the intercept path was built to monitor this SVC, the task 
event trap-handling routine issues an ICONT macro to return 
the SVC to the OS/32 executor for execution. 


If the intercept path was built to service the SVC, the task 
event trap-handling routine processes the SVC by the 
intercept macros IGET, I[PUT, [ROLL and _ MITRAP. Also, the 
routine can issue the IPROCEED macro to allow the application 
task to continue executing during SVC processing. 


After the task event trap-handling routine processes the SVC, 
it issues an ITERM macro that transfers control back to the 
application task that issued the SVC. 


The intercepting task exits the trap handler through the 
TEXIT macro. 


48-040 FOO RO3 4-3 


4.3 PREPARING A TASK FOR SUPERVISOR CALL (SVC) INTERCEPTION 
Before creating an intercept path, an intercepting task must: 


e build a set of RDB buffers for each type of SVC to be 
intercepted, 


# build a circular list to store the addresses of the RDB 
buffers, and 


@® be prepared to handle a task event trap. 


4.3.1 Request Descriptor Block (RDB) Buffers 


The size of each RDB buffer built by the intercepting task 
depends on the size of the parameter block for the particular SVC 
to be intercepted. For example, a set of buffers allocated for 
SVC6 interception will be larger than a set of buffers for SVCl 
interception. When an intercepting task uses one set of buffers 
for intercepting two or more SVC types, the buffer size must 
equal the size of the RDB needed to hold the largest parameter 
block associated with the SVCs to be intercepted. Figure 4-1 
shows the RDB fields. -To define a structure containing these 
fields, use the $RDB macro. 


+0(00) }2(02) Intercept path | 
\ Reserved H identifier i 
4 (RDB.RID) i (RDB.PID) i 
poe Se See ae eon CSS Sh St SRR SHS SS SSS ease | 
14(04) 16(06) 1'7(07) Task \ 
i Parameter block offset | SVC type { priority i 
H (ROB. OFF ) H (RDB.SVC) | (RDB.TPRI) H 
(Lae aoe aS Sees SS SSeS eS SS Se SSSR ae SS SRS Se Sera | 
18(08) 
i OS task identifier i 
| (RDB.TID) { 
(oS es SSS See Se Sea ae SSR See SS See See SSeS SASS H 
112(0C) 
H SVC parameter block address ' 
(RDB. PAD) 
(carte telson cis eee irigiacine waists GUNS AMA diana a 
{16(10) Instruction address following { 
' intercepted SVC instruction H 
(RDB .SVAD) 
H es ies a a nt ae a ss, Sg aa Sm is aa ms nein) sm, Sa eine, a a hes eg! nh Gon eae peep ea 
20(14) SVC parameter block 
(RDB .PB) 


Figure 4-1 Request Descriptor Block 
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Fields: 


Reserved 
(RDB.RID) 


Intercept 
path 
identifier 
(RDB.PID) 


Parameter 
block 
offset 
(RDB.OFF ) 


svc 
type 
(RDB .SVC) 


Task 
priority 
(RDB.TPRI ) 


OS task 
identifier 
(RDB.TID) 


SVC parameter 
block address 


(RDB. PAD) 
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The fields contained within the RDB are described as follows: 


is a halfword field reserved for future use. 


is a halfword field containing an SVC 
intercept path identifier exclusively reserved 
for one particular SVC interception. 


is a halfword field containing the hexadecimal 
offset value for the parameter block field 
within the RDB. 


is a l-byte field containing a decimal number 
specifying the type of SVC that is to be 
intercepted. 


@e 01 indicates SVCL. 

@ 02 indicates SVC2, code 7. 

e 03 indicates SVC3. 

e 06 indicates SVC6. 

@ 07 indicates SVC7. 

is a 1-byte field containing a decimal number 
specifying the priority of the task that 
issued the intercepted SVC. 

is a 4-byte field containing the operating 
system task identifier for the task that 
issued the intercepted SVC. 

is a 4-byte field containing a hexadecimal 
number specifying the address of the parameter 
block for the SVC being intercepted. For 


SVC3 interceptions, this field contains the 
end of task code. 


Instruction is a 4-byte field containing a hexadecimal 


address number specifying the address of the instruc- 
following tion following the intercepted SVC 
intercepted instruction. This field is set to oO for 
svc SVC3 interceptions. 

instruction 

(RDB .SVAD) 

SVC parameter is a variable length field containing the 
block parameter block of the intercepted SVC. 

(RDB. PB) 


4.3.2 Circular List for Request Descriptor Block (RDB) Buffers 


The intercepting task must have a standard Perkin-Elmer circular 
list to hold the address of each RDB buffer. Figure 4-2 shows 
the fields of the standard circular list. When an SVC is sent to 
the intercepting task for processing, one RDB buffer address is 
automatically removed from the circular list, and the RDB is 
filled with information identifying the intercepted SVC. The 
circular list can be created by the assembler instruction DLIST. 
See the appropriate Perkin-Elmer Series 3200 Processor User's 
Manual or the Instruction Set Reference Manual for a more 
detailed explanation of the standard circular list. 


10(00) 12(02) 
H Maximum number | Current number i 
H of buffers H of buffers { 
era anki eee dak ae Re ce Pe RS Ee dae Ge a 
14(04) 16 (06) 
H Current top H Next bottom H 
1 t ’ 
hE a aa tk ea tee ere ! 
18 (08) 
' A (buffer 1) | 
i H 
[PRS Sere eSS Sh SSSR Ste Keres See SSS Se Steer etre RS SR SSeS HS SHSe H 
i 12(0C) H 
H A (buffer 2) H 
i H 
I ar a 
{ . i 
H 
i 
| oe een me em nme ern 
: A (buffer n) i 


a i a a a a a a i a ee a a i a a ee ee ae a ee ee 


Figure 4-2 System Task Buffer List (Standard Circular List) 
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Fields: 


Max imum is ahalfword field indicating the maximum 
number of number of fullwords in the entire list. 
buffers 

Current is a halfword field indicating the number of 
number of fullwords currently in use. When this’ field 
buffers equals zero, the list is empty. When this 


field equals the number of fullwords in the 
list, the list is full. 


Current top is a halfword field indicating the address of 
the RDB buffer that is currently at the top of 
the list. 


Next bottom is a halfword field indicating the address of 
the next RDB buffer that is at the bottom of 
the list. 


A (buffer n) indicates the address of an RDB buffer. 


4.3.3 Task Event Trap 


To receive a task event trap, an intercepting task must have the 
TSW.TESB bit in its task status word (TSW) set. See the 0S/32 
Application Level Programmer Reference Manual for more 
information: on TSW bit settings. If this bit is not set, the 
task event trap will be queued until a TSW is loaded with this 
bit set. In addition, a task cannot receive a task event trap or 
task queue trap during execution of the task event trap-handling 
routine. These traps will be queued until the task exits from 
the routine. 


Before execution branches to the task event trap-handling 
routine, the operating system places the address of the RDB in 
register 1 and a unique intercept path identifier in register 0. 
To prevent the data in these registers from being lost during 
execution of the task event trap~-handling routine, the 
intercepting task should be link-edited with the TEQSAVE task 
option. TEQSAVE informs the operating system which register 
contents should be saved and restored when a task enters or exits 
the task event trap-handling routine. See the 0OS/32 Link 
Reference Manual for more information on TEQSAVE. 


4.4 CREATING INTERCEPT PATHS ( ICREATE ) 


Before an intercepting task can intercept an SVC, it must create 
a path to the application task that contains the SVC to be 
intercepted. This path is created by executing code built by the 
ICREATE macro that informs the OS/32 SVC executor which SVC is to 
be intercepted by this path. The intercepting task also accesses 
the application task's address space through the intercept path. 
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An intercept path remains in effect until it is removed by the 
intercepting task creating it or until the intercepting task 
terminates. Although only one type of SVC can be intercepted by 
each path, there is no limit to the number of paths that can be 
created by one intercepting task. 


The mode parameter of the ICREATE macro specifies when an SVC is 
to be intercepted. Under caller mode, the specified SVC is 
intercepted every time it is issued by the application task. 
When the recipient existent mode is specified, the SVC is 
intercepted only when it is directed toward a specified task, 
device, pseudo task or pseudo device that exists in the system. 
Under the recipient nonexistent mode, the SVC is intercepted only 
when it is directed toward a specified pseudo task or pseudo 
device created by execution of code built by the ICREATE macro. 


4.5 HOW TO CREATE A PSEUDO DEVICE OR TASK WITH ICREATE 
A pseudo device consists of a name and the SVCl or SVC7 intercept 


paths attached to it. The pseudo device name, which is known to 
the system but does not actually refer to any system device or 


file, consists of a device name, filename and_ extension. A 
device name that does not already exist for a real device or disk 
volume must be used. Pseudo devices ignore the file 


class/account number field of the file descriptor (fd). 


When the operating system cannot find a device or filename in the 
system, it will search the list of pseudo devices. If a match 
occurs, the system will continue processing the SVC using the 
pseudo device. 


To create a pseudo device using SVC interception software, the 
ICREATE macro should be set to specify either an SVCl or SVC7. 
The recipient nonexistent mode should also be specified. An SVC1 
intercept path must be in effect when an input/output 1/0 
operation is attempted to a pseudo device; otherwise, an invalid 
function (X'CO') error status is returned. 


A pseudo task consists of a name attached to one or more SVC6 
intercept paths. A pseudo task name is known to the system but 
does not refer to an actual task existing in the system. 


To create a pseudo task, issue the ICREATE macro specifying SVC6 
and the recipient nonexistent mode. Because a pseudo task does 
not refer to a real task, the pseudo task cannot be cancelled. 
Both pseudo tasks and pseudo devices can be deleted by removing 
all intercept paths attached to them. 
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4.6 USE OF GENERIC NAMING FOR PSEUDO DEVICES AND TASKS 


A pseudo device or task can be generically named. The following 
characters can be used for generic naming: 


@ An asterisk (*) represents any character or blank. 


@ A backward slash (\) represents any character. 


If a pseudo device or task name specifies the filename and 
extension fields as blanks, the system substitutes filename and 
extension fields filled with asterisks. This has the effect of 
generically naming the filename and extension fields so that they 
will always match the input filename and extension. 


If the operands of an ICREATE macro specify the recipient 
existent mode and a generic pseudo device or task name, a pseudo 
device or task must exist with its name exactly matching the one 
specified by ICREATE. An error will result if the names do not 
match. For example, a system is asked to create the following 
pseudo devices: 

@ FAKE:FILEL 

@ FAKE:FILE* 

@ FAKE: 

@ FAKE:FILE*.EXT 


Normally, the following input will match the above pseudo 
devices: 


INPUT NAME SELECTED PSEUDO DEVICE 
FAKE: FAKE: 

FAKE: F ILE3 FAKE : FILE* 

FAKE: F ILE1 FAKE: FILEL 

FAKE: FILE11 FAKE: 

FAKE: FILEX.EXT FAKE: FILE* .EXT 

FAKE: F ILEX.EX FAKE : 


When the code built by the ICREATE macro is issued, specifying 
recipient nonexistent mode and the pseudo device FAKE:, the 
ICREATE function will not be performed because the pseudo device 
already exists. Consequently, when an ICREATE macro is used, 
specifying recipient existent mode along with the pseudo device 
FAKE:FILE*, ICREATE will be executed because the pseudo device 
FAKE: FILE* already exists. 
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4.7 FUNCTIONAL SUMMARY OF SUPERVISOR CALL (SVC) INTERCEPTION 


The following describes how interception works for each SVC and 
mode: 


SVCl caller 


Svcl 
recipient 
existent 


SVC1 
recipient 
nonexistent 


SVC2 code 7 
caller 


SVC2 code 7 
recipient 
existent 


SVC2 code 7 
recipient 


_ nonexistent 


SVC3 caller 


SVvc3 
recipient 
existent 


SVC3 
recipient 
nonexistent 


SVC6 caller 


SVC6 
recipient 
existent 


SVC6 
recipient 
nonexistent 


SVC7 caller 


Any SVC1L issued by the specified task is 
intercepted. 

Any SVCl directed to a logical unit (lu) 
assigned to the specified device or pseudo 


device is intercepted. (Note that disk volume 
interception is not supported for SVC1.) 


The pseudo device is 
call specifying an lu 
device is intercepted. 


created, and any SVCL 
assigned to this pseudo 


Any SVC2 code 
is intercepted. 


7 issued by the specified task 


This call is invalid. 
This call is invalid. 


If the specified task goes to end of task for 
any reason, an SVC3 intercept will occur. 


This call is invalid. 
This call is invalid. 


Any SVC6 issued by the 
intercepted. 


specified task is 


Any SVC6 directed to the 
or pseudo task is intercepted. 


specified task 


The pseudo task is created, and any SVC6 
call directed to this pseudo task is 
intercepted. 
Any SVC7 issued by the specified task is 
intercepted. 
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SVC7 Any SVC7 directed to the specified device, 


recipient disk volume or pseudo device is intercepted. 
existent 

SVC7 The pseudo device is created, and any SVC7 
recipient call specifying this pseudo device is 
nonexistent intercepted. 


4.8 FULL AND MONITOR CONTROL INTERCEPT PATHS 


The ICREATE macro specifies the level of control that the 
intercept path allows an intercepting task to have over an 
application task. 


A full control intercept path allows the intercepting task to 
exert full control over a task whose SVC has been intercepted. 
Specifically, the intercepting task can: 


e Make the task rollable via the [ROLL macro. When an SVC _ is 
intercepted, the task that issued the SVC is placed in a wait 
state and made nonrollable. At the discretion of the 
intercepting task, the application task can be made rollable 
(assuming the application task can be rolled). 


@ Allow the application task to execute while it processes a 
proceed SVC via code built by the IPROCEED macro. When an SVC 
is intercepted, the application task that issued the SVC is 
placed in a wait state and made nonrollable. At the 
discretion of the intercepting task, the application task that 
issued the intercepted SVC can proceed with its execution 
while the intercepting task processes the SVC. 


@e Obtain data from the application task memory space via the 
IGET macro. 


@e Write data into the writable memory space of the application 
task via the IPUT macro. 


@e Send a task queue trap to the application task via the ITRAP 
macro. While processing the SVC, the intercepting task may 
find it necessary to send a task queue trap to the application 
task. The task queue item sent must have a valid OS/32 reason 
code in the high-order byte. In addition, the TSW of the 
application task must have the task queue entry (TQE) bit 
associated with the reason code set. 


A monitor control intercept path allows the intercepting task to 
be notified whenever one of the designated SVCs is issued by an 
application task. Monitor control differs from full control in 
that once OS/32 has sent the task event trap to the intercepting 
task, the SVC is passed to the appropriate OS/32 executor and the 
task that issued the SVC proceeds with normal processing. 
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The following guidelines should be followed when assigning a 
level of control to the intercept path: 


@ Only monitor control can be specified for SVC3 intercept 
paths. Either full or monitor control can be specified for 
all other SVC type intercept paths. 


@ Only one full control intercept path can be attached to a 
device or task (or pseudo device or task) for each type of SVC 
to be intercepted. 


e A task or device (or pseudo task or device) can be attached to 
any number of monitor control intercept paths. 


Example: 


ICREATE NAME=DEVNAME , MODE=RX, CONTROL=FC,SVC=(7) 
ICREATE NAME=DEVNAME , MODE=RX, CONTROL=FC,SVC=(1) 
ICREATE NAME=DEVNAME , MODE=RX, CONTROL=MC , SVC=(7) 
ICREATE NAME=DEVNAME , MODE=RX , CONTROL=MC ,SVC=(1) 


DEVNAME DC C' ' DEFINE 8 BLANK CHARACTERS 
DC C'MAG '' 
Dc Cc! ' DEFINE 8 BLANK CHARACTERS (FD) 


Dc c' ' DEFINE 4 BLANK CHARACTERS (EXTENSION) 


In this example, a full control SVC7 intercept path is attached 
to device MAG:. A full control SVCl intercept path is also 
attached to MAG:. No other SVCl or SVC7 full control intercept 
paths can be attached. Of course, any number of SVCl and SVC7 
monitor control intercept paths can be attached to MAG:; here, 
one SVC7 and one SVCl monitor control paths are attached. 


4.9 HOW INTERCEPT PATHS HANDLE SUPERVISOR CALIS (SVCs) OCCURRING 
AT END OF TASK 


SVCl and SVC7 can be intercepted during end of task processing 
(including end of task processing after cancel), if intercept 
paths exist from these SVCs to devices assigned to the task's 
logical units. The intercepting task must be careful when 
writing into the operating system address space while executing 
these SVCs so as not to destroy the system's integrity. 


If the application task is cancelled while the intercepting task 


is processing the SVC, SVC processing is aborted and the 
application task proceeds to end of task. 
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4.10 TERMINATING THE INTERCEPTED SUPERVISOR CALLS (SVCs) 


When the intercepting task receives an SVC from a full control 
intercept path, the intercepting task has the option of returning 
the SVC to the operating system for processing. To do this, the 
intercepting task executes code built by an ICONT macro that 
allows the operating system to resume processing the intercepted 
Svc as if the intercept had never occurred. The ICONT macro 
cannot be used if an IPROCEED or IROLL macro has been used. 


If the intercepting task chooses to process the SVC, the 
intercepting task executes code built by an ITERM macro after the 
svc is processed. ITERM terminates the interception and, if no 
IPROCEED has been issued, allows the application task to resume 
execution with the instruction immediately following the 
intercepted SVC instruction. 


Either ICONT or ITERM can be used to terminate interception from 
a monitor control intercept path. The system does not 
differentiate between the two cails in this case. Here the ICONT 
or ITERM macro replaces the RDB buffer address back on the 
circular list. It is very important that the ICONT or ITERM 
macro be used to replace the RDB. 


Cancelling an application task under monitor or full control 
aborts the processing of the intercepted SVC in progress. The 
intercepting task must still issue an ICONT or ITERM to terminate 
the SVC interception. 


4.11 HOW TO REMOVE INTERCEPT PATHS 


An intercepting task can remove an intercept path by executing 
code built by an IREMOVE macro specifying the path to be removed. 
IREMOVE can be used for both immediate and delayed termination 
depending on whether the controlled shutdown or abort option is 
chosen. 


The controlled shutdown option refuses all incoming requests’ and 
completes the servicing of all existing queued and executing 
SvCs. When processing of the last existing SVC intercepted by 
the path is completed, the path is removed from the system. 


The abort option terminates all existing queued and executing 
SVCs before removing the intercept path from the system. 


4.12 ERROR HANDLING 


Run-time errors that result from executing intercept macro code 
are handled by user-written error routines within the 
intercepting task. When an error occurs, execution branches to 
the routine specified by either the IERRTST macro statement or 
the error parameter associated with each macro. 
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The IERRTST macro is issued immediately after a macro for which 
the error parameter has been omitted. If an error occurs, 
execution of the intercepting task will branch to a user-written 
error routine to handle the error. Error codes returned by the 
IERRTST macro are listed in Table 4-2. If no error occurs, 
execution continues at the instruction following the IERRTST 
macro. 


If the ERROR parameter is specified with an intercept macro and 
an error occurs, execution branches to the specified error 
routine within the intercepting task. If no error occurs, 
execution proceeds to the next executable statement. The error 
routine pointed to by the ERROR parameter can contain an’ IERRTST 
macro to identify what error has occurred. 


TABLE 4-2 ERROR CODES RETURNED FOR INTERCEPT MACROS 


‘MEANING 


ee ee ee een ee tre ee ee ee ee ee ee ee ee enn eee eee 


Invalid address in parameter control block ICREATE 
(PCB) ITERM 


Insufficient system space to do request, 
or NINTC > 64, or PBSIZE > 998, 


Full control already selected. ICREATE 


i 

‘ 

{| TROLL 

| IPROCEED 


FD ' Invalid device name or task name. i ICREATE  } 
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TABLE 4-2 ERROR CODES RETURNED FOR INTERCEPT MACROS 


(Cont inued) 
} ERROR } | RELEVANT |} 
| CODE } MEAN ING | MACROS | 
{ aS. SSS SSS SS SSS SS SST SSVI SKS SIC SESE SSS KAISER SVS SSS SSS SESS SSE SIS STs | 
{ sT i Invalid state for call; e.g., IROLL | ICONT : 
i | followed by ICONT or issuing INPUT with | IREMOVE | 
i } monitor control intercept path. } IROLL 1 
i i {| IPROCEED | 
| ITRAP 
| i {| IGET H 
| IPUT i 
H Fa sep tas EN eee eee a wie a eae eas ares ad Sasa dac Oe Pe ORS Veins (ct tt cated nar enters BU ewan i ee Se ah Ss | 
i TP | Task queue item not added. | ITRAP | 
fe RS a ee ae a a oe ey ee ce ee ee i 
i RD i Invalid RDB. | ITERM i 
| | TCONT 
' } IROLL i 
i | IPROCEED |} 
; ITRAP | 
' } IGET i 
H 1 | IPUT H 
|e esa casi ane oi LSA Es BT 
i ID { Intercept path corresponding to this path | IREMOVE | 
H {| ID does not exist. 1 } 
Feriarnumiar ay e'p Gea aes ais agen EE CARE INOS TE ER CET alas! | 
i WR |; Attempt to copy SVC parameter block back | ITERM H 
{ | into write-protected area. | i 
| en nn een em nnn nnn na nena 
i CD } Invalid subcode in SVC parameter block. i} All H 
H i SVC interception software not included at | { 
| |} sysgen. 
pasa Sa ae ee See SSeS i 
| NT i Intercepted task has gone to end of task. | IROLL | 
; | IPROCEED | 
i H | ITRAP i 
;} IGET i 
H ;} IPUT 1 


4.13 MACROS USED WITH SUPERVISOR CALL (SVC) INTERCEPTION 


Once configured for SVC interception, the operating system allows 
tasks to execute code built by macros for SVC interception 
provided the tasks were linked with the intercept option. 


This section gives the syntax for the SVC macros described in the 


previous sections. See the 0S/32 System Macro Library Reference 
Manual for a list of syntax rules. 
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4.13.1 ICREATE Macro 


The ICREATE macro creates an intercept path for a particular SVC 
type. See Table 4-3 for valid combinations for the SVC, MODE and 
NAME parameters. 


Format: 
| | l 
NAME {| OPERATION jj} OPERAND 

(1) 

(2,7) 
symbol ICREATE SVC=<(3) 
(6) 
(7) 

cL 

, MODE=<RX 

RN 


,NAME=pointer 
,TID=pointer 
he 
, CONTROL= 
MC 
,BUFFERL=po inter 
[, HANDLER=po inter] 
,PID=pointer 
,EXEC=pointer 
[, PBSIZE=n] 
[, SVAR=pointer] 
[, ERROR=po inter] 
[, PCB=pointer ] 
[ FORM=L ] 


[NINTC=n] 
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Operands: 


SVC= is an integer, enclosed by parentheses, that 
indicates the type of intercept path to be 
created: 


e (1) indicates SVC1 
e (2,7) indicates SVC2 code 7 
® (3) indicates SVC3 
@ (6) indicates SVC6 
@® (7) indicates SVC7 

MODE= indicates one of the following interception 
modes: 
e CL indicates caller mode 
e RX indicates recipient existent mode 
e RN indicates recipient nonexistent mode 
When CL is specified, an intercept path is 
created for all SVCs (selected by the SVC 
parameter) issued from the task specified in 
the NAME or TID parameter. 
When RX is specified, an intercept path is 
created for all SVCs (selected by the SVC 
parameter) directed to an existing task, 
device, pseudo task, or pseudo device 


specified in the NAME parameter. 


When RN is specified, a pseudo device is 


a 


Operands: 


SVC= 


MODE= 
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is an integer, enclosed by parentheses, that 
indicates the type of intercept path to be 
created: 


@® (1) indicates SVC1 

e (2,7) indicates SVC2 code 7 

@ (3) indicates SVC3 

@ (6) indicates SVC6 

@e (7) indicates SVC7 

indicates one of the following interception 
modes: 

e CL indicates caller mode 

e RX indicates recipient existent mode 

e RN indicates recipient nonexistent mode 
When CL is specified, an intercept path is 
created for all SVCs (selected by the SVC 
parameter) issued from the task specified in 
the NAME or TID parameter. 

When RX is specified, an intercept path is 
created for all SVCs (selected by the SVC 
parameter) directed to an existing task, 
device, pseudo task, or pseudo device 
specified in the NAME parameter. 

When RN is specified, a pseudo device is 
created for SVCl or SVC7, or a pseudo task is 
created for SVC6. The pseudo device or task 
is attached to the intercept path created by 
the call. 


A pseudo task or pseudo device is deleted when 
all intercept paths attached to it are 


removed. When a pseudo device is assigned 
without SVC7 interception, the requested 
access privileges are ignored and_e shared 
read/shared write privileges are granted. If 


an SVCl is attempted to a pseudo device 
without an interception in effect, an invalid 
function error (X'CO') is returned. 


NAME= indicates the address of the memory location 
specifying the name of a device task, pseudo 
device or pseudo task. This location must be 
fullword boundary-aligned and contain eight 
bytes of blanks followed by a standard fd or 
task identifier (taskid). An fd must be 
packed, left-justified, and padded with blanks 
within the fullword. A taskid must. be 
left-justified and padded with blanks. 


When RX or RN is-7 specified by the MODE 
parameter, the standard fd or taskid given 
with the NAME parameter can include an 
asterisk (*) or a backward slash (\) to allow 
generic naming. See Section 4.6. 


TABLE 4-3 VALID COMBINATIONS FOR SVC, MODE AND NAME 
PARAMETERS 


Svc= | MODE= | NAME= | FUNCTION 
(1) | CL | taskid |} Intercepts any SVCl issued from the task. 
RX fd Intercepts any SVCl directed to the 


we ee es ee me ee ee ee ee 


i] 
H { 
{ ' existing device. 
| RN i 
H H 


fd Creates a pseudo device and intercepts 
any SVCl directed to it. 

ee ee ee ce ee ce ee ee a ee ee ee ee ne ee ee ee a ee ae ee a ee ee ee ee ms ee ee ec i 
(2,7) {| CL | taskid | Intercepts any SVC2 code 7 issued | 
H H { from the task. H 

{ RX i a ! No function; specifying fd or taskid H 

1 { { results in error. | 

| RN { as i Results in error. 

(3) { CL ' taskid |} End of task interception; occurs no H 
i | | matter how a task terminates. H 

i; RX H = 1 No function; specifying fd or taskid H 

{ { i results in error. { 

i RN H ee { Results in error. 

(6) i CL | taskid } Intercepts any SVC6 issued from the task. | 
} RX | taskid | Intercepts any SVC6 directed to the | 

H H { existing task. { 

1} RN | taskid | Creates a pseudo task and intercepts | 

H { { any SVC6 directed to it. | 

em ce ee ee i ee ee ae we we ee ee ee eee a ee ee re re re a ee ee ae ee ee ee ee ee ea | 
(7) + CL ! taskid | Intercepts any SVC7 issued from the task. | 
i RX i fd {| Intercepts any SVC7 directed to the i 

' H } existing device. i 

| RN i fa ! Creates a pseudo device and intercepts 

i i i i 


any SVC7 directed to it. 
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TID= 


CONTROL= 


BUFFERL= 


HANDLER= 


PID= 
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indicates the address of a fullword location 
containing a taskid. This parameter, which is 
mutually exclusive with the NAME= parameter, 
can be used when MODE=CL, or MODE=RX with 
Svc6, to identify the task to be intercepted. 
The TID can be obtained from the RDB.TID field 
of an RDB from a_ previously intercepted SVC 
call. : 


contains a mnemonic indicating either full 
control (FC) or monitor control (MC) over 
intercepted SVCs. 


When CONTROL=FC, an intercepting task can 
exert full control over an application task's 
intercepted SVCs. 


When CONTROL=MC, an intercepting task acts as 
a monitor only; it has no control over an 
intercepted SVC. 


indicates the address of the standard circular 
list that contains the addresses of available 
RDB buffers. 


The RDB used by the intercepting task to 
identify an intercepted SVC must not be moved 
to a new location after the interception takes 
place. The system ensures that the address of 
this RDB is the same as the address of the RDB 
that was passed to the intercepting task when 
the interception occurred. 


indicates the address of a fullword location 
containing the name of a queue handler. This 
name, a maximum of eight characters, is 
left-justified and padded with blanks. If 
this parameter is omitted, the default queue 
handler is invoked. 


NOTE 
Currently, user-defined queue 


handlers are not supported. 


indicates the address of a halfword location 
that is used by the system to store the path 
identifier for the intercept path. 


EXEC= 


PBSIZE= 


SVAR= 


ERROR= 


is the address of an SVC intercept executor 
routine within the intercepting task. This 
routine will process intercepted SVCs of the 
type specified with the SVC parameter. During 
Svc interception, the system removes an RDB 
specified by the list, fills it with 
information, and queues a task event trap with 
the specified executor address to the 
intercepting task. 


On entry to an executor routine, general 
register 0 contains the PID of the intercept 
path and general register 1 contains the 
address of the RDB buffer associated with the 
intercepted svc. The executor routine 
executes as a task event service routine. 


specifies the number of bytes in the parameter 
block for the SVC indicated by the svc 
parameter. 


When this parameter is omitted, the parameter 
block size defaults to the standard sizes 
documented for each type of SVC in the 0S/32 
Supervisor Call (SVC) Reference Manual, except 
for SVC2 code 7 interception, which defaults 
to eight bytes. 


The size of the RDB.PB field in the RDB for 
this interception path is the value of the 
PBSIZE parameter (or its default if PBSIZE is 
not specified). 


is the address of a fullword location 
containing user-defined data. This data is 
passed to the intercept = logic. The queue 
handler named by the HANDLER parameter can 
later access the data. The SVAR parameter is 
for user-defined purposes when needed by a 
user-defined queue handler. 


NOTE 


Currently, user -—def ined queue 
handlers are not supported. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for this macro, execution branches to this 
error routine. If this parameter is omitted 
and a run-time error occurs, execution resumes 
with the instruction following code built by 
the macro. 
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PCB= 


FORM= 


NINTC= 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. 


When no PCB parameter is included, macro code 
automatically builds a new PCB and initializes 
it with values corresponding to the other 
specified parameters. 


L requests a PCB to be built but not executed. 
Macro code constructs a PCB for this macro and 
initializes it with values. Subsequent macros 
can reference this PCB via the PCB parameter. 


n specifies the number of interceptions that 
can be handled concurrently for this intercept 


path. If there are more SVC interceptions 
outstanding than can be handled concurrently, 
the excess interceptions are queued. The 


Gefault value for n is l. 


4.13.2 IREMOVE Macro 


The IREMOVE macro allows an intercepting task to remove one or 
all previously created SVC intercept paths. 


Format: 
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Se ome ees em ey es em se cme cee mt we ree es ce ere me ee ee se we ee ee 


IREMOVE 


PID=pointer 


cs 
: TERI) ; 


| [,ERROR=po inter] 
{ 
: 
i 
H 


[-PCB=pointer] 


[-FORM=L,] 


Operands: 


PID= 


TERM= 


- ERROR= 


PCB= 


FORM= 


is the address of the path identifier 
specifying the path being removed. A zero 
value in the PID halfword removes all existing 
intercept paths. 


indicates either of two termination modes for 
intercepted SVCs already queued for the 
intercepting task: 


e AB indicates’) abort. 0S/32 aborts all 
currently queued requests before path 
removal. 


e@ cS indicates controlled shutdown. 08/32 
services only currently queued requests 
before path removal; requests made after 
TERM=CS is issued cannot be queued or 
processed. 


If this parameter is omitted, AB is the 
default. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for this macro, execution branches to this 
error routine. If this parameter is omitted 
and a run-time error occurs, execution resumes 
with the instruction following the macro. 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. 


If this parameter is omitted, a mew PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


L requests that a PCB be built but not 
executed. A PCB is built by this macro and 
initialized with values. Subsequent macros 
can reference this PCB via the PCB parameter. 
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4.13.3 IGET Macro 


The IGET macro allows an intercepting task to get data from the 
application task whose SVC is intercepted. 


Format: 


Operands: 


ADEND= 


48-040 FOO RO3 


RDB=pointer 
,ADST=pointer 
,ADEND=pointer 


,SDST=pointer 


[, ERROR=po inter] 
[ PCB=pointer] 
[, FORM=T. | 


i 

i 

} 

i 

i 

i 

i 

i 

| ,SDEND=pointer 
t Z 

| 

H 

H 

\ 

i 

| [/DONE=addr] 
! 

t 


is the address of the RDB buffer built for the 
intercepted SVC. 


is the start address of a data area within the 
application task whose SVC is’ intercepted. 
The contents of this area are transferred to 
an intercepting task data area. 


is the end address of the data area within the 
application task whose SVC is intercepted. 


4.13 


SDST= 


SDEND= 


ERROR= 


PCB= 


FORM= 


DONE= 


-4 IPUT Macro 


is the start address of a data area within the 
intercepting task. This area receives the 
data from the application task. 


is the end address of the data area within the 
intercepting task. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for this macro, execution branches to this 
error routine. If this parameter is omitted 
and a run-time error occurs, execution resumes 
with the instruction following the macro. 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


L requests a PCB be built but not executed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can reference 
this PCB via the PCB parameter. 


is an address that specifies that the macro is 
to be a PROCEED call. When the call is 
completed, a task event interrupt occurs, 
using the routine specified by the address in 
the DONE parameter. This routine enters with 
RO containing the error code for the call and 
Rl pointing to the macro's parameter block. 
Once this routine has finished processing, it 
exits using the code built by the TEXIT macro. 


The proceed form of the IGET macro must be 
used if an IROLL macro was’ issued to the 
application task whose SVC is intercepted. 
The system cannot guarantee that the 
application task is in memory or that it can 
be rolled into memory within a_ reasonable 
time. 


The IPUT macro lets an intercepting task put data into a data 
area of the application task whose SVC is intercepted. 
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Format: 


1 
' 
NAME {| OPERATION 


Operands: 


ADEND= 


SDST= 


SDEND= 


ERROR= 
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RDB=pointer 
,ADST=pointer 
,ADEND=pointer 


,oDST=pointer 


[, ERROR=po inter] 
[, PCB=pointer ] 
[; FORM=L, ] 


i 

i 

' 

i 

} 

i 

i 

i} ,SDEND=pointer 
{ 

! 

| 

| 

| 

{ 

' 

| [,DONE=addr] 
4 

' 


is the address of the RDB buffer built for the 
intercepted SVC. 


is the start address of a data area within the 
application task. This area receives the 
contents of an intercepting task data area. 


is the end address of the data area within the 
application task. 


is the start address of a data area within the 
intercepting task. The contents of this area 
are put into the application task data area. 


is the end address of the data within the 
application task. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for code built by this macro, execution 
branches to this error routine. 


If this parameter is omitted and a _ run-time 
error occurs, execution resumes with the 
instruction following the macro. 


4.13.5 


PCB= 


FORM= 


DONE= 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


L requests a PCB be built but not executed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


is an address that specifies that the macro is 
to be a proceed call. When the call is 
completed, a task event interrupt occurs, 
using the routine specified by the address in 
the DONE parameter. This routine enters with 
general register 0 containing the error code 
for the call, and general register 1 pointing 
to the macro's parameter block. Once this 
routine has finished processing, it exits 
using the code built by the TEXIT macro. 


The proceed form of the IPUT macro must be 
used if an IROLL macro was’ issued to the 
application task. The system cannot guarantee 
that the application task is in memory or that 
it can be rolled into memory within a 
reasonable time. 


ICONT Macro 


The ICONT macro relinquishes control of an intercepted SVC by 
returning control to an 0S/32 SVC executor. 


Format: 


| 
t 
OPERATION ; OPERAND 


RDB=pointer 


[, ERROR=pointer ] 


1 
i 
‘ [,PCB=pointer ] 
t 
1 
| [,FORM=L] 

( 

{ 
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Operands: 


RDB= is the address of the RDB buffer built for the 
intercepted SVC. 

ERROR= is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for code built by this macro, execution 


branches to this error routine. 


If this parameter is omitted and a_ run-time 


error occurs, execution resumes with the 
instruction following the code built by the 
macro. 

PCB= is the address of a PCB previously constructed 


and initialized by the FORM=L parameter. 


If this parameter is omitted, a mew PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


FORM= L requests a PCB be built but not accessed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


4.13.6  JIPROCEED Macro 


After an SVC has been intercepted, the intercepting task can 
execute code built by an IPROCEED macro to allow the application 
task that issued the SVC to proceed with its execution. Until 
the intercepting task executes code built by an IPROCEED macro, 
the application task is in a wait state. 


Format: 
i i 
NAME ;} OPERATION {| OPERAND 
symbol IPROCEED RDB=pointer 


[, ERROR=po inter] 
(, PCB=po inter] 
[, FORM=L] 


[,cc=n] 
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Operanda: 


RDB= is the address of the RDB buffer built for the 
intercepted SVC. 


ERROR= is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for code built by this macro, execution 
branches to this error routine. If this 
parameter is omitted and a run-time error 
occurs, execution resumes with the instruction 
following code built by the macro. 


PCB= is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a mew PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


FORM= L requests a PCB be built but not assessed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


CC= n is a decimal number specifying the setting 
of the application task program status word 
(PSW) condition code after the SVC instruction 
execution. If the CC parameter is omitted, 
the condition code of the application task PSW 
is set to zero. 


4.13.7 IROLL Macro 

After an SVC is intercepted, an IROLL macro lets an intercepting 
task change the status of the application task from nonrollable 
to rollable, provided that the task was established as rollable 


by UGink. This allows 0OS/32 to roll out a task having an 
intercepted SVC that requires lengthy processing. 


Format: 


OPERATION OPERAND 

“symbol } TROLL} RDB=pointer ss” 
[, ERROR=pointer] 

[, PCB=pointer | 


[ FORM=L ] 
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Operands: 


RDB= is the address of the RDB buffer built for the 
intercepted SVC. 


ERROR= is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for this macro, execution branches to this 
error routine. If this parameter is omitted 
and a run-time error occurs, execution resumes 
with the instruction following the macro. 


PCB= is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


FORM= L requests a PCB be built but not accessed. 
A PCB is built for this macro and initialized 
with values. Subsequent macros can refer to 
this PCB via the PCB parameter. 


4.13.8 ITERM Macro 


The ITERM macro terminates SVC processing. It also allows an 
intercepting task to return the parameter block of the SVC it 
processed to the application task that issued the Svc. The 
returned parameter block can have updated information such as 
status, number of bytes transferred, etc. 


Format: 
i 
NAME {| OPERATION |} OPERAND 
symbol ITERM RDB=pointer 


, TRAP=pointer 


(, ERROR=pointer ] 
C PCB=po inter] 
[, FORM=L.] 


[,cc=n] 
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Oper 


4.13 


ands: 


COPY= 


ERROR= 


PCB= 


FORM= 


is the address of the RDB buffer built for the 
intercepted SVC. 


is the address of a fullword that contains an 
item to be added to the task queue of the 
application task whose SVC is intercepted. 


Y (yes) indicates that the SVC parameter block 
in the RDB is to be copied back into the 
parameter block of the intercepted SVC. 


N (no) indicates the copy operation is not 
performed. If this parameter is omitted, N is 
the default. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for code built by this macro, execution 
branches to this error routine. If this 
parameter is omitted and a run-time error 
occurs, execution resumes with the instruction 
following the code built by the macro. 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


L requests that a PCB be built but not 
accessed. A PCB is built for this macro and 
initialized with values. Subsequent macros 
can refer to this PCB via the PCB parameter. 


n is a decimal number specifying the setting 
of the application task PSW condition code 
after the SVC instruction execution. If the 
CC parameter is omitted, the condition code of 
the application task PSW is set to zero. 


.9 ITRAP Macro 


The ITRAP macro allows an intercepting task to send a task queue 
item to 
queue item can be any of the task queue items supported by OS/32. 


an application task whose SVC is intercepted. The task 
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Format: 


Operands: 


RDB= 


TID= 


TRAP= 


ERROR= 
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4 
' 
OPERATION | OPERAND 


ee ee es mee ee eee ce cre cme cee ee ree ee ree ae re ee ee en ee ee ee ee ee ee ee ee ee 


RDB=pointer 
eee 
,TRAP=pointer 
[, ERROR=po inter] 
[, PCB=pointer] 
[ FORM=L ] 


[, DONE=addr] 


is the address of the RDB buffer built for the 
intercepted SVC. 


is the address of a fullword containing the 
taskid for the task. Before issuing an ITRAP 
macro with the TID parameter, the intercepting 
task must have obtained the task identifier 
from an RDB and placed it into the fullword 
location. 


NOTE 


The TID form of this macro can be 
used to send a trap to a task that 
is not being intercepted. 


is the address of a fullword that contains an 
item to be added to the task queue of the 
application task having an svc that is 
intercepted. 


is the address of an error routine within the 
intercepting task. If a run-time error occurs 
for code built by this macro, execution 
branches to this error routine. If this 
parameter is omitted and a run-time error 
occurs, execution resumes with the instruction 
following the code built by the macro. 


4.13.10 


PCB= 


FORM= 


DONE= 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a mew PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


L requests that a PCB be built but not 
accessed. A PCB is built for this macro and 
initialized with values. Subsequent macros 
can refer to this PCB via the PCB parameter. 


is an address that specifies that the macro is 
to be a PROCEED call. When the call is 
completed, a task event interrupt occurs, 
using the routine whose address is specified 
in the DONE parameter. This routine enters 
with general register 0 containing the error 
code for the call and general register 1 
pointing to the macro's parameter block. Once 
this routine has finished processing, the 
intercepting task exits using code built by 
the TEXIT macro. 


The proceed form of the ITRAP macro must be 
used if an IROLL macro was specified in the 
application task having an SVC that is 
intercepted. The system cannot guarantee that 
the application task is in memory or that it 
can be rolled into memory within a reasonable 
time. 


IERRTST Macro 


The IERRTST macro allows an intercepting task to evaluate errors 
resulting 
order to branch to appropriate error handling routines. 


Format: 


from 


execution of code built by intercept macros in 


4 
' 
OPERATION j; OPERAND 


IERRTST 


xx=pointer 


[xx=pointer] 
ELSE=pointer 
E | 
PCB=pointer 
[ J 


[FORM=L ] 
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Operands: 


XxX 


pointer 


ELSE= 


PCB= 


FORM= 
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is a two-character alphabetic string 
specifying one of the error codes for the 
intercept macros. See Table 4-2. 


specifies the name of an intercepting task 
error routine that handles’ errors having a 
returned error code identical to the one 
specified by the xx parameter. For instance, 
an IERRTST macro might include these 
parameters for evaluating an [PUT macro: 


IERRTST AD=pointer ,NT=pointer ,RD=pointer 


These parameters specify the addresses of the 
error routines to which execution will branch 
whenever the returned error code equals AD, NT 
or RD. 


is the name of an error routine to be executed 
for errors other than those specified in the 
xX parameter. If this parameter is omitted, 
one of the following actions occurs for 
returned errors: 


e If the returned error code corresponds’ to 
the one specified by the xx parameter, 
execution branches to a especific error 
routine. 


e If the returned error code does not 
correspond to the one specified by the xx 
parameter, execution branches to the 
instruction immediately following the code 
built by the IERRTST macro. 


is the address of a PCB previously constructed 
and initialized by the FORM=L parameter. If 
this parameter is omitted, a new PCB is 
automatically built and initialized with 
values corresponding to the other specified 
parameters. 


L requests that a PCB be built but not 
accessed. A PCB is built for this macro and 
initialized with values. Subsequent macros 
can refer to this PCB via the PCB parameter. 


4.13.11 $RDB Macro 
The $RDB macro is used to define a _ structure containing the 
symbolic names for all of the RDB fields. It is recommended that 


symbolic names be used to refer to the RDB fields instead of 
coding the hexadecimal offsets to the fields. 


Format: 


OPERATION 


4.14 SAMPLE SUPERVISOR CALL (SVC) INTERCEPTION PROGRAMS 
The following program uses SVC interception software to intercept 


SVCl to the existing real device MAGI. Each time an SVCl is 
issued to MAG], the program prints the following message: 


Svc 1 CALL, INTERCEPTED 


The SVCl is terminated with a device unavailable error code 
(X'AO'). 


$RDB DEFINES AN RDB STRUCTURE 


* ADD AN RDB BUFFER ADDRESS TO THE RDB BUFFER ADDRESS LIST. 


LA 0, RDB LOAD THE ADDRESS OF THE RDB 
x INTO REGISTER O 

ABL 0,BUFLIST ADD THE ADDRESS OF THE RDB 
* TO THE CIRCULAR LIST 


* CREATE THE INTERCEPT PATH 


ICREATE NAME=INTNAME, FD FOR DEVICE NAME x 
MODE=RX, RECIPIENT-EXISTENT MODE x 
CONTROL=FC, GIVES INTERCEPTING TASK FULL CONTROL X 
SvcC=(1), ALL SVC 1 ARE TO BE INTERCEPTED xX 


EXEC=INTRTN, POINTS TO THE SVC EXECUTOR ROUTINE x 
BUFFERL=BUFLIST, ASJIGNS POINTER TO FREE BUFFER LIST X 
PID=PATHID, DATA AREA FOR INTERCEPT PATH ID x 
ERROR=BOMBOUT ERROR ROUTINE FOR ICREATE MACRO 
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* IF ERROR OCCURS IN ICREATE MACRO ENABLE TASK EVENT TRAP SO TASK 


* 


CAN GO INTO TRAP WAIT FOR INTERCEPTS TO OCCUR 


* LOAD TSW WITH WAIT STATE SET AND TASK EVENT TRAPS ENABLED 


LTSW TETS ,WT 


* COME HERE IF ERROR OCCURS IN ICREATE MACRO 


BOMBOUT 


Svc 3,1 FAIL TASK ON ERROR 


* ALLOCATE DATA AREA FOR ICREATE 


ALIGN 4 
INTNAME DC Cc! ; NODE NAME 

Dc Cc! ' RESERVED 

pc C'MAG1' DEVICE NAME 

DC Cc! ' FILE NAME PART 1 

pc Cc! ' FILE NAME PART 2 

Dc Cc! ' EXTENS ION 
BUFLIST DLIST 1 DESIGNATE 1 RDB IN CIRCULAR LIST 
RDB Ds RDB .PB+20 ALLOCATES SIZE OF RDB + SVC 1 
PATHID DS 2 DESIGNATE AREA FOR PATH ID 
* TRAP EVENT SERVICE ROUTINE 
* THE FOLLOWING ROUTINE IS EXECUTED WHEN AN SVC IS INTERCEPTED 
INTRTN SVC 2,NOTIFY LOG MESSAGE THAT SVC 1 WAS INTER- 
x CEPTED 

LHI 0,X'AQOO' RETURN DEVICE UNAVAILABLE STATUS 
* FOR INTERCEPTED SVC 1 

STH 0,RDB.PB+2(1) SAVE SVC 1 STATUS IN STATUS FIELD 
* OF RDB 
* 
* TERMINATE THE INTERCEPTED CALI, COPYING THE MODIFIED SVC 
* PARAMETER BLOCK IN THE RDB BACK OVER THE USER'S SVC PARAMETER 
* BLOCK. 


ITERM RDB=(1),COPY=Y 


TEXIT EXIT THE TASK EVENT ROUTINE 


* ALLOCATE DATA AREA FOR TRAP EVENT SERVICE ROUTINE 


NOTIFY 


ALIGN 4 

DB O,7,0,22 ; 

DC c'svC 1 CALL INTERCEPTED‘ 
END 
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The following program creates a pseudo device to which a user 
task (u-task) can assign and write. The user's data buffer is 
passed to the 0S/32 command processor via SVC2 code 14 to be 
executed as a command line. 


IRDR PROG SVC INTERCEPT EXAMPLE - INTERNAL READER 
SOOO OOO IGG OIISGIIIGIGOIG IE IGIGIERIGIGOIGECRGOG GIORGIO COO CK 


FOO III IIIS IOC OI IOI IGIGIOIOIGIOIOI IGG OOIGIGIGIGIGIGGIOR IOI 
* , * 


* * 
* This task creates a pseudo device to which a u-task ba 
* can assign and write. The user's data buffer is 7 
* passed to the operating system command processor via x 
. an SVC2 code 14 to be executed as a command line. x 
* : x 
x * 


FOO III IOI OOO IO IG IOI II IGG IOI OGG OGIO III III IOC IO 
FORO OOO IO OIG IID IOIOIOIO OIG IGOR IGOR ICI IOI IOI ICIGIGIIGIGIG ICICI IOI IC 


ROO EQU O 
ROL EQU) 1 
RO2 EQU 2 
RO3 EQU 3 
RO4 EQU 4 
ROS EQU 5 
ROG EQU 6 
RO7 EQU 7 
ROS EQU 8 
ROO EQU 9 
R10 EQU 10 
Ril EQU 11 
R12 EQU 12 
R13 EQU 13 
R14 EQU 14 
R15 EQU 15 
SPACE 3 
NLSTM 
NLSTU 
$SVC1 
$SVC7 
$RDB 


TITLE INTERCEPT PATH CREATION 
FOI OO OGIO OGIO IO ICIS III OOOO OOOO OOOO OOO IOS IK 


* x 
= SET UP INTERCEPT PATHS * 
* x 


OOOO I IOI OI OIG GIGI IOI GIGI OIG GIO IORI IOC OIC IOI 
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IRDR EQU 


* 


SVC 2,PEEKO1 GET NAME OF SYSTEM CONSOLE 
L ROO, CON 
ST ROO,SVC7 .VOL+SVC7CON 
LHI ROO,SV7.ASGN!SV7.SRW 
SLL ROO,16 ASSIGN LU 0 SRW 
ST ROO, SVC7.OPT+SVC7CON 
svc 7,SVC7CON ASSIGN TO SYSTEM CONSOLE 
LB ROO,SVC7 .STA+SVC7CON 
LR ROO,ROO WAS THE ASSIGN OK? 
BNZ BADCON NO 
LIS ROO,O CHANGE SVC 7 TO FETCH ATTR 
STH ROO, SVC7 .OPT+SVC7CON 
SVC 7,SVC7CON FETCH ATTRIBUTES ON CON: 
LB ROO,SVC7 .STA+SVC7CON 
LR ROO, ROO WAS THE FETCH OK? 
BNZ BADCON NO 
LHI ROO,SV7.CLOS CHANGE SVC 7 TO CLOSE 
SRLS ROO,8 DO NOT DESTROY DEVICE CODE 
STB ROO, SVC7 .OPT+SVC7CON 
SVC 7,SVC7CON CLOSE THE SYSTEM CONSOLE 
LB ROO, SVC7 .STA+SVC7CON 
LR ROO, ROO WAS THE CLOSE OK? 
BNZ BADCON NO 
LHI ROO,X'7FFF' BAD LENGTH FOR SVC 2,14 TO GET 
STH ROO, COMMAND+4 MAX LENGTH ALLOWED BY SYSTEM 
Svc 2, COMMAND WILL GET ERROR STATUS 3 
LH ROO, COMMAND+6 USE AS IRDR LENGTH 
STH ROO, SVC7.LRC+SVC7CON 
SPACE 1 
LHI ROO, RDBNUM NUMBER OF RDB'S 
LA RO1,RDBPOOL ADDRESS OF RDB POOL 
INTRDB EQU * 
ATL RO1,RDBP ADD RDB TO QUEUE 
AHI RO1,RDBSIZE ADDRESS OF NEXT RDB 
SIs ROO,1 ALL RDB'S ADDED TO QUEUE? 
BNZ INTRDB NO 
SPACE 1 


ICREATE SVC=#(7) ,MODE=RN,NAMIE=NAME, 


CONTROL=FC, BUFFERL=“RDBP , PID=PID, EXEC#INT7 


IERRTST FD=BADFD,EX=BADEX, EILSE=BADALL 


ICREATE SVC=(1) ,MODE=RX,NAME=NAME, PBSIZE=SVC1X, 
CONTROL=FC, BUFFERL=RDBP, PID=PID,EXEC=INT1 


IERRTST FD=BADFD,EX=BADEX , E].SE=BADALL 


SPACE 1 
LTSW WT,TETS ENTER TRAP WAIT 
SPACE 3 
BADFD svc 2,LOGFD 
SVC 3,1 
BADEX svc 2,LOGEX 
svc 3,1 
BADALL svc 2, STRANGE 
SVC 3,1 
BADCON SVC 2, LOGCON 
SVC 3,1 
SPACE 1. 
ALIGN 4 
LOGFD Dc H'7',H'8' 
pbc C'FD ERROR’ 
LOGEX Dc H'7',H'8!' 
pe C'EX ERROR' 
STRANGE DC H'7',H'8' 
DC C'tt ERROR’ 
LOGCON Dc H'7',H'12' 
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NAME 
PID 


RDBNUM 
RDBSIZE 
RDBP 
RDBPOOL 


pc C'!!CON ERROR ' 


SPACE 1 

pe c' TRDR : 

DSF 1 

SPACE 1 

EQU 3 NUMBER OF RDB'S IN POOL 
EQU RDB .+SVC7. MAXIMUM SIZE OF RDB 
DLIST RDBNUM RDB POOL 

DS RDBS I ZE*RDBNUM RDB BUFFERS 


TITLE SVC 7 TEQ HANDLER 


FOI III IOI IOI OIG IOI OIOIOIOIOIOIOIOIOIOIDIOIOI OIG OIGOOIGIOII III IO III OICIOK 


x 
* 
x 


INT? 


INT7 .NS 


* 


SVC 7 INTERCEPT EXECUTOR x 
* 
SOO IORI IOI OI SII IOI OI IOI OOO IOI III GIO I IOIOI IOI IID III OIC IOI IOIOICIOIOI OI IO 
EQU * 
LR R10,RO1 SAVE RDB POINTER 
LR R11,R10 
AH R1l,RDB.OFF (R10) ADDRESS OF SVC 7 PBLK 
LB ROO,SVC7.OPT(R11) GET SVC 7 OPTIONS 
LR ROO, ROO FETCH ATTRIBUTES? 
BZ DOFETCH YES 
CLHI ROO,X'FF' EXTENDED SVC 7 FUNCTIONS? 
BE INT7.NS YES - NOT SUPPORTED 
THI ROO,X'40' ASSIGN? 
BNZ DOOPEN YES 
THI ROO,x'O4' CLOSE? 
BNZ DOCLOSE YES 
THI ROO,X'21' CHAP OR CHECKPOINT? 
BNZ  INT7.1G YES - IGNORE 
SPACE 1 
EQU) * 
Svc 2,UNPACK7 PUT SVC 7 OPTION IN ERROR MESSAGE 
SVC 2,LOG7ERRC AND LOG ERROR MESSAGE 
LIS  R0O,1 RETURN ILLEGAL FUNCTION TO USER 


* 
x 
x 


INT7.IG 


DOOPEN 


STB ROO, SVC7.STA(R11) AS AN ERROR STATUS 
ITERM PCB=TERM,RDB=(R10) TERMINATE THIS SVC 7 
TEXIT PCB=EXIT EXIT FROM TEQ HANDLER 
SPACE 3 


IGNORE SVC 7 COMMAND PROCESSOR 


EQU * 

ITERM PCB=TERM,RDB=(R10) IGNORE THIS SVC 7 
TEXIT PCB=EXIT EXIT FROM TEQ HANDLER 
SPACE 3 


OPEN PROCESSOR 


EQU x 

LB R15,SVC7.OPT+1(R11) GET ACCESS PRIVILEGES 

SRLS R15,5 SRO = 0 & ERO = 1 

CLHI R15,2 REQUESTING READ ONLY ACCESS? 
BL OPEN .ERR YES - ERROR 

B OPEN . OK SKIP SECURITY CHECK 

SPACE 2 

SS SSS= USER DEFINED SECURITY CHECK FOLLOWS —~—--~--7 7s ttt rrr rrr 
L R15,RDB.TID(R10) MOVE TID FOR PEEKO3 

ST R15,TID 

svc 2,PEEKO3 INFO ON USER TASK 

LM R14,MONITOR GET NAME OF USERS MONITOR 
CLI R14,C' .MTM' TASK A SUB-TASK OF MTM? 

BNE OPEN . OK NO 

CLI R15,C' : BE SURE 
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OPEN . OK 


OPEN . ERR 


* 
DOFETCH 


EQU 


Q 
© 
me 


EQU 

ICONT 
TEXIT 
SPACE 


FETCH 


STM 

ITERM 
TEXIT 
TITLE 


OPEN .OK 
R14, TASKNAME 
R14,C'LEE ' 
OPEN .ERR 
R15,C' “ 
OPEN . ERR 
R15, LEGACY 
R15,C'cT42' 
OPEN .ERR 
R15,ACCT.P 
R15, 29 

OPEN .ERR 
R15,ACCT.G 
R15,18 


PCB=CONT, RDB= (R10) 
PCB=EXIT 

2 

* 

R15,9 
R15,SVC7.STA(R11) 
PCB=TERM, RDB=(R10) 


? PCB=EXIT 


3 


PROCESSOR 


* 
PCB=<CONT, RDB=(R10) 
PCB#EXIT 

3 


NO? 
GET NAME OF USER 
IS IT ME? 


GET NAME OF USERS TERMINAL 

IS IT MINE? 

NO 

GET USERS PRIVATE ACCOUNT NUMBER 
AM I IN MY ACCOUNT? 

NO 

GET USERS GROUP ACCOUNT NUMBER 

DO I HAVE MY CORRECT GROUP ACCOUNT? 
NO 


RETURN TO OS SVC 7 EXECUTOR 
EXIT FROM TEQ HANDLER 
RETURN ASSIGNMENT ERROR TO USER 


RETURN BAD STATUS TO USER 
EXIT FROM TEQ HANDLER 


RETURN OS OS SVC 7 EXECUTOR 
EXIT FROM TEQ HANDLER 


ATTRIBUTES PROCESSOR 


* 


RO9, SVC7CON 
R15,SVC7.OPT+1(RO09) 
R15,SVC7.OPT+1(R11) 
R15,0 
R15,SVC7.STA(R11) 
R15,SVC7.KEY(RO9) 
R15,SVC7.KEY(R11) 
R15,NAME+8 
R15,SVC7.VOL(R11) 
R12,SVC7.FNM(RO9) 
R12,SVC7.FNM(R11) 
PCB=TERM, RDB=(R10) 
PCB=EXIT 

svc 1 TEQ HANDLER 


GET ADDRESS OF FETCH ATTR OF CON 
MOVE DEVICE CODE 


GOOD STATUS 
DEVICE ATTR & RECORD LENGTH 


IRDR DEVICE NAME 


RETURN SVC 7 FETCH PBLK TO USER 
EXIT FROM TEQ HANDLER 


SUKI KIKI III OI IOI OOOO OOO ROK 


x 
* 
x 


svc 1 


INTERCEPT EXECUTOR 


* 
x 
x 


XO IKI OOOO OROIOIOSOIOIOIIO SOTO OOOO SUI OOO KK aK KK ok 


INTL 
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* 


R10,RO1 
RO7,R10 
RO7,RDB.OFF (R10) 
R14,0 

R15,0 


SAVE RDB ADDRESS 


ADDRESS OF SVC 1 PBLK 
NO ERROR ON COMMAND FUNCTION 
LENGTH OF TRANSFER 


e & 0M 


INT1.WRT 


ECHODONE 


ECHOWAIT 


UNPACK7 


LOG7ERRC 


SVC7ERRC 
LOG 7ERRX 


TRAP 


CONT 


TERM 


LB R13,SVC1.FC(RO7) GET FUNCTION CODE 
THI R13,SV1.CMDF COMMAND FUNCTION? 


BNZ ECHODONE YES - TREAT AS A NOP 
THI R13,SV1.WRIT IS USER DOING A WRITE? 
BNZ INT1.WRT YES 


A read from the internal reader will give the 
user an illegal function status. 


LHI R14,X'Co00' ILLEGAL FUNCTION ON READ 
B ECHODONE FINISH UP 


Queue the user's command line to the internal reader 


EQU * 

L R11,SVC1.SAD(RO7) GET START ADDRESS 

L R12,SVC1.EAD(RO7) AND END ADDRESS 

IGET RDB=(R10) , SDST=BUFFER, SDEND=BUFEND x 
ADST=(R11) ,ADEND=(R12) 

SR R12,R11 GET LENGTH-1 OF STRING 

LR R15,R12 

AIS R15,1 LENGTH OF USER COMMAND LINE 

STH  R15,COMMAND+4 

SVC 2,COMMAND PASS COMMAND TO IREADER 

LH R14, COMMAND+ 2 COMMAND QUEUED TO IREADER? 

BZ ECHODONE YES 

LHI R14,X*'AQOO' NO - GIVE DEVICE UNAVAILABLE 

SPACE 1 

EQU * 

STH  R14,SVC1.STA(RO7) RETURN STATUS 

ST R15,SVC1.LXF(RO7) RETURN LENGTH 

THI R13,SV1L.WAIT IS USER REQUEST A WAIT? 

BNZ ECHOWAIT YES - NO NEED FOR A TRAP 

SPACE 1 

L R15,RDB.PAD(R10) GET ADDRESS OF USER SVC 1 PBLK 

Ol R15,¥'08000000' 1/O PROCEED COMPLETION PARAMETER 

ST R15,TRAP 

SPACE 1 

ITERM RDB=(R10),TRAP=TRAP, COPY=¥ TERMINATE WITH TRAP 

TEXIT PCB=EXIT EXIT FROM TEQ HANDLER 

SPACE 1 

EQU  * 

ITERM PCB=TERM,RDB=(R10) TERMINATE THIS SVC 1 

TEXIT PCB=EXIT EXIT FROM TEQ HANDLER 

EJECT 

ALIGN 4 

DB 2,6,0,0 PUT SVC 7 ERROR CODE IN 

DAC  SVC7ERRC 

DB 0,7 

pc Z(LOG7ERRX-* ) 

DB C'UNSUPPORTED SVC 7 FUNCTION ' 

DB C'.. INTERCEPTED ' 

EQU *-1 

SPACE 2 

ALIGN 4 

DS 4 1/O PROCEED COMPLETION TRAP 

SPACE 2 

ALIGN 4 

ICONT FORM=L CONTINUE SVC 

SPACE 2 

ALIGN 4 

ITERM FORM=L, COPY=Y¥ TERMINATE SVC 

SPACE 2 

ALIGN 4 
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EXIT 


PEEKO1 


CON 


SVC7CON 


PEEKO3 


COMMAND 


BUFFER 
BUFEND 
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FORM=L 
2 

4 

1,19 
22 


3,19,0,0 


1 
2 
1 
1 
1 
1 
1 
1 
2 
1 
2 
1 
1 


,14,0,0 
(BUFFER) 


28 
-1 


3 
3 
4 
1 
0 
8) 
A 
1 
4 
1 
* 
IRDR 


EXIT SVC 


SYSTEM CONSOLE NAME 


GET INFO AN USER TASK 

USER TASK ID 

NAME OF USER TASK 

CURRENT TASK STATUS WORD 
TASK OPTIONS 

TASK WAITS 

USER'S PRIVATE ACCOUNT NUMBER 
USER'S GROUP ACCOUNT NUMBER 
LOAD VOLUME NAME 

LOAD FILE NAME 

LOAD EXTENSION & FILE CLASS 
NAME OF MONITOR TASK 

NAME MTM USERS TERMINAL 
TASK PRIORITY 

(RESERVED ) 


QUEUE COMMAND TO IREADER 
STATUS 


ADDRESS OF BUFFER 


CHAPTER 5 
O$/32-SUPPORTED INPUT/OUTPUT (1/0) DEVICES 


5.1 INTRODUCTION 


This chapter discusses the functional aspects of the devices 
supported by 0S/32. Specific device-dependent information is 
included. 


OS/32 devices and files support ASCII formatting, sequential 
access, unconditional and conditional proceed I/0, and vertical 
forms control (VFC). Device codes associated with Perkin-Elmer 
Supported devices range from 0 to 255. These codes are defined 
in the System Generation/32 (Sysgen/32) Reference Manual. 


5.2 VERTICAL FORMS CONTROL (VFC) 

VFC provides a means to control the vertical forms motion on an 
output device, such as a line printer or CRT, while writing data. 
Available VFC functions are: 

e@ Set vertical tabs (EVFU) 

@ Vertical space 0-79 before or after printing 

@ Vertical tab before or after printing 

@ No space before or after printing (overprint) 

e Select VFU channels 2-12 before and after printing 

® Horizontal tabs (available with bidirectional input/output 


control (BIOC) and local line printer drivers only) 


The VFC character is the first character of the user's output 
buffer and is interpreted to mean one of the above functions. 
VFC characters supported by OS/32 drivers are listed in Appendix 
B. Other bytes in the buffer are considered to be data and are 
output without further interpretation. 


The 08/32 routines that control VFC can be shared by all drivers 
requiring VFC character recognition. OS/32 makes no assumption 
as to the type of device calling the routines; device 
specification is maintained by each individual driver. 
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5.2.1 Horizontal Tabs 


When the BIOC driver encounters a horizontal tab character, the 
Griver replaces the character with one or more spaces, as 
determined by the tab stops that were established by the last 
down line load. If a horizontal tab character is encountered at 
a column position beyond the last tab stop, it will be replaced 
by one space. If a horizontal tab character is encountered while 
positioned on a tab stop, the necessary number of spaces will be 
output to position to the next tab stop. 


The local line printer driver expands the tab character (control 
I) to the appropriate number of spaces. Tab stops are defined to 
be every eighth column; i.e., columns) 9, 17, 25, etc. This 
feature is enabled via extended device code Xl for device codes 
112, 113 or 114 only. All other drivers output the horizontal 
tab character unmodified. 


5.2.2 Theory of Operation 


For devices that support ASCII output operations (e.g., a line 
printer), a write operation begins with a call to the write 
initialization routine to determine if there is any VFC operation 
to be performed before printing. 


If a VFC character is present, the driver performs the VFC 
operation designated by that character. The driver then outputs 
the user's data buffer. On completion, the driver checks for any 
VFC operations that are to be performed after the data is output. 
If a VFC operation is required, the driver performs it. If no 
"after" VFC operation is required, but the current output is VFC, 
the driver enters into a line feed (LF) pending state for the 
next write operation. 


For drivers that support both input and output operations (e.g., 
a CRT driver), output operations are performed in the same manner 
as above. However, the procedure for input operations differs 
slightly. Before an input operation, the cursor remains 
positioned where the last output operation left it. To prevent 
the characters that are input from overwriting the previous line, 
the drive delays echoing the first character input until an LF is 
output. Two types of LF echoing can be performed: 


e Software-echo (e.g., BIOC drivers) 

e@e Hardware-echo (e.g., ITAM PPSM drivers) 

If a driver uses the software-echo feature, (i.e., the driver 
echoes the characters that are typed in via software control), 
the driver waits for the first character to be typed in by the 


operator and then performs a VFC operation if it is in LF pending 
state before the character is echoed. 
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If a driver uses the hardware-echo feature and is in LF pending 
State, the driver first turns off the echo, waits for the input 
character to be typed, performs the VFC operation, outputs the 
character just typed in, and finally turns the hardware-echo back 
on for the remainder of the buffer. 

5.3 CARD READERS 


Perkin-Elmer card readers can accommodate a fixed record length 
of 80 bytes (ASCII), 120 bytes (binary) or 160 bytes (image). 


During read ASCII operations, each card column (12 bits) is 
converted into one 8-bit ASCII character. Illegal codes are 
converted into the null character (X'00') indicating an error has 
occurred. 

During read binary operations, each pair of card columns (12 bits 
each) is unpacked into three bytes having the following format. 


Read Binary Format: 


First card column 


During read image operations, each column is converted into one 
halfword in the following format (U=undef ined). 


Read Image Format: 
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The translation for an ASCII read is accomplished through a 
translation table. Devices without hardware translation 
translate 029- or 026-compatible Hollerith code to 8-bit ASCII 
code. Source sysgen options include translation of 029- or 
026-compatible Hollerith code to EBCDIC code. The hardware 
translation matches that of the 029-compatible Hollerith to 
EBCDIC translation. 


5.4 CARD READER/PUNCH DEVICES 

Card reader/punch devices supported by Perkin-Elmer 32-bit 
processors accommodate fixed record lengths of 80 bytes (ASCII), 
120 bytes (column binary) and 160 bytes (image). 

During read ASCII operations, each card column (12 bits) is 
converted into one 8-bit ASCII character. Illegal codes are 
converted into the null character (X'00') indicating an error has 
occurred. 

During read binary operations, each pair of card columns (12 bits 
each) is unpacked into three bytes having the following format. 


Read Binary Format: 


First card colum 


Second card column 


[tia a a eee 


During read image operations, each card column (12 bits each) is 
placed into a halfword in the following format. 


Read Image Format: 


ee ee eect a a a ss ee em ome ass Ce ye ale mt ni en ‘Se pe ener eens ei, ae ar ee See mee en 


we cere eee ere ee ee ee ee ere ear me ee came ee eee ee re ree ee ee cee ee ce me ae ee ee ee ee ee nee ee ee eee oe ee 
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During write ASCII operations, each byte of data is translated 

from ASCII into a 12-bit Hollerith code. Depending on the device 

code chosen, the following can occur: 

@ All data is punched and printed. 

@ Data is punched only. 

@ Of each 160 bytes of data accepted, the first 80 bytes are 
punched while the second 80 bytes are printed. 


During write binary operations, each 3-byte group is packed into 
two columns on the card in the following format. Nothing is 
printed on top of the card. 


Write Binary Format: 


Oda Column 


During write image operations, the low order 12 bits of each 
halfword are punched according to the following format. Nothing 
is printed on top of the card. Bits O through 3 are ignored. 


Write Image Format: 


ee ee ee ec a ee SS chm Sr ces me chy ary es cre ee tt ane cm em ee re me mm mh te ee ee mee ware ee ee ee ee ee ee ee ee oe 


The translation for ASCII operations is accomplished through a 
translation table. The standard translation is 8-bit ASCII code 
to 029-compatible Hollerith code. 
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Source sysgen options include 8-bit ASCII code to 026-compatible 
Hollerith code and also EBCDIC code to 026- or 029-compatible 
Hollerith codes. 


5.5 TELETYPE (TTY) READER/PUNCH 


Perkin-Elmer TTY reader/punch devices support read and write 
ASCII, read and write binary, and read and write image 
operations. Variable length records are also accommodated. 


During read ASCII operations, an X-ON character is output to turn 
the reader on. The tape is read in blocked mode so data is not 
copied to the printer while it is being read. Leading blank 
frames and delete characters are ignored. Data is masked to 
7-bit ASCII. The transfer is terminated on buffer full or when 
a carriage return (CR) character is read, whichever occurs first. 
On termination of the transfer, the tape is advanced to the next 
delete character or blank frame. An X-OFF character is output to 
stop the tape. 


During read binary operations, an X-ON character is output to 
turn on the tape. The tape is skipped until the first nonblank 
frame is found. If the first monblank character is xX'FO', 
subsequent frames are read in until the user buffer is full. The 
characters are read in unzoned binary format. 


If the first nonblank character read is not X'FO', the characters 


are read in zoned binary format, stripped of their zones, and 
packed into the user buffer. Transfer begins with the first 
nonblank frame after X'FO'. Only punches xX'90', X'81' through 
X'84', and X'95' through X'9F' are read. Other characters are 


ignored. When the user buffer is full, the tape is advanced to 
the next blank frame. 


During read image operations, none of the above formatting 
operations are performed. An X-ON character is output to turn 
the tape on, and data is read into the user buffer until the 
buffer is full. The X-OFF character is then output to turn the 
tape off and the transfer is complete. 


During write ASCII operations, the driver outputs a RUBOUT-TAPE 
RUBOUT-RUBOUT sequence in order to initialize the TTY 
reperforator. Eight frames of blank tape are output as a leader. 
The user data is output until the buffer is empty, or a CR 
character is encountered, whichever occurs first. The driver 
ensures that a CR-LF-TAPE OFF-RUBOUT sequence terminates the 
record. 


During write binary operations, the driver outputs a 
RUBOUT-TAPE-RUBOUT-RUBOUT sequence, followed by eight’ blank 
frames of leader. The user buffer is output, translating each 
byte into two frames of zoned binary data. The transfer is 
terminated when the buffer is empty. The driver outputs a TAPE 
OFF~-RUBOUT sequence. 
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During write image operations, none of the above formatting or 
control operations are performed. The user buffer is output 
until the buffer is empty. 


On ASCII or image write, it is possible to inadvertently turn off 
the punch by outputting a TAPE OFF character. On image write, it 
is the responsibility of the user to place the necessary control 
characters, such as TAPE and TAPE OFF, in the user buffer to 
control the operation of the tape. 


Since the reader/punch portion of the TTY is connected to the 
keyboard/printer portion, only one of these devices can be active 
at atime. On ASCII write, the data punched on the tape is also 
printed on the printer. 


5.6 TELETYPE (TTY) KEYBOARD/PRINTER 


Perkin-Elmer TTY keyboard/printers accommodate variable length 
records and can be interfaced to current loop devices. 


In non-VFC read ASCII operations, data read is masked to /7-bit 
ASCII. Data is read until the buffer is full or a CR is found, 
whichever occurs first. Upon termination, a carriage return/line 
feed (CR/LF) sequence is sent to the printer. 


In non-VFC write ASCII operations, the buffer is scanned to 
eliminate trailing blanks. Data is then output until the buffer 
is exhausted or until a CR is found in the data stream. An LF is 
automatically appended to the detected CR; or no CR is detected, 
a CR/LF sequence is output after the last nonblank character. 


During non-VFC image I/O, none of the above formatting actions 
occur. The amount of data requested is printed or read in, 
without masking to 7-bit ASCII, eliminating trailing blanks, 
checking for control characters, or detecting or appending CRs or 
LFs. On image read, a CR is detected as an end of line sentinel. 


For information on I/O operations with VFC, see Section 5.2. See 
the 0S/32 Operator Reference Manual for an explanation of the 


function control keys available on Perkin-Elmer TTY 
keyboard/printers. 
While the reader/punch of an ASR TTY is treated as a separate 
device, it cannot operate simultaneously with the 
keyboard/printer. 


5.7 PAPER TAPE EQUIPMENT 


Variable record lengths are supported by Perkin-Elmer paper tape 
aGevices. During read ASCII operations, leading blank tape and 
delete characters are ignored. Data is masked to 7-bit ASCII. 
CR terminates read. On termination, the tape is advanced until 
either a blank frame or a delete character is read. 
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During read binary operations, tape is advanced until a nonzero 
character is read. If this character is X'FO', the tape is read 
until the buffer is full (unzoned binary). If the first nonzero 
character is not xX'FO', the tape is treated as a zoned binary 
tape. Each two characters are stripped of their zones, merged 
into one byte, and placed in the buffer until the buffer is full. 
On buffer full, the tape is advanced until blank tape is found. 
In zoned binary mode, the only valid characters are: X'90', 
X'81' through X'84' and xX'95' through X'SF'. All other 
characters cause the transfer to end with a transfer error 
status. 


During read image operations, the tape is read until the buffer 
is full. 


During write ASCII operations, eight frames of blank tape are 
output. The user buffer is output up to (but not including) CR 
or until the buffer is empty. CR/LF is then output. 


During write binary operations, eight frames of blank tape are 
output followed by the character xX'FO'. The user buffer is 
output until the buffer is empty. 


During write image operations, the user buffer is output until 
the buffer is empty. 


5.8 LINE PRINTERS 


Perkin-Elmer line printers support variable record lengths up to 
132 bytes. 


During non-VFC write ASCII operations, the user buffer is output 
until a CR is found or until the buffer is empty. At buffer 
termination, the system ensures that the buffer is printed and 
the paper is spaced upward one line. During non-VFC write image 
operations, the user buffer is output exactly as it exists in 
memory . The system does not ensure that the data is printed or 
that the paper is properly moved. The user should be familiar 
with the characteristics of the particular device being used. 


For information on I/O operations with VFC, see Section 5.2. 


5.9 TAPE CASSETTE 


Variable length records are supported by Perkin-Elmer tape 
cassettes. During input, ASCII, binary and image modes are 
identical. Data is read from the cassette into the user buffer. 
The transfer terminates when the buffer is full or at end of 


record, whichever comes first. If the record is longer than the 
buffer, error status is not returned. Parity errors in the 
unread part of the record can be detected. If a parity error 
occurs, five retries are attempted before error status is 


returned. When a parity error status is returned, the tape is 
positioned in the interrecord gap following the record in error. 
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During output, ASCII, binary and image modes are identical. Data 
is written from the user buffer until the buffer is empty . The 
system retries five times on parity errors. 


The driver generates an end of tape condition, whether the tape 
is positioned at the beginning or at the end of the reel. It 
must be assumed from the last operation what position end of tape 
is actually referring to. 


Since the two drives on an intertape cassette share logic, only 
one drive of a cassette pair (e.g., X'45' and X'55') can be 
active at a time. 


Continuous mode operations are used to pass requests to the 
driver within the time required (10ms for read; 30ms_ for 
backspace). 


5.10 MAGNETIC TAPE 


Data transfer operations can be performed in standard and gapless 
I/O format. 


5.10.1 Standard Input/Output (1/0) 


Variable length records are supported by Perkin-Elmer magnetic 
tape devices. During input, data is read into the user buffer 
from the magnetic tape. The transfer ends on buffer full or end 
of record, whichever comes first. If a parity error occurs, the 
driver retries the read operation before an error status is 
returned. The number of retries performed is determined by the 
retry value set in the DCB or specified by the user in the SVCL 
extended function code field for data transfer operations. After 
a parity error occurs during a read forward operation, the tape 
is positioned in the interrecord gap preceding the record with 
the error. If an error occurs during a read backward operation, 
the tape is physically positioned following the record with the 
error. 


During output, data is written from the user buffer to the 
magnetic tape until the buffer is empty. On parity error, the 
tape is positioned before the record causing the error, the 
record gap is extended and the write operation is retried. 
Again, the number of retries is determined by the retry value set 
in the DCB or specified in the SVCl parameter block. 


In addition to giving users control over the number of retries 
for data transfer errors, OS/32 provides the ability to erase a 
variable length of tape and to select the recording density, via 
SvCl and SVC7, respectively. See the OS/32 Supervisor Call (SVC) 
Reference Manual for more information on how to implement these 
features. 


For read and write requests, ASCII, binary and image requests are 
identical. 
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The minimum number of bytes that can be transferred by a tape 
drive is four. All data transfers must start on a halfword 
(i.e., even byte) boundary and should specify an even number of 
bytes (i.e., end address odd). 


On a read operation, end of tape can be detected on a different 
record than on a write operation because of mechanical tape 
positioning. If rewind is issued at beginning of tape, the 
driver returns normal status. Ensure that the tape is loaded at 
beginning of tape unless some other condition is expected. 


5.10.2 Gapless Input/Output (1/0) 


Data transfer operations in gapless mode consist of a task 
reading or writing data buffers to a magnetic tape with no 
intervening interrecord gaps, using only one SVC1l. To perform 
gapless I/0 to a magnetic tape, a task must issue an SVCl call 
that specifies, among other things, a pair of buffer queues, the 
IN-QUEUE and the OUT-QUEUE. The driver takes buffers from the 
IN-QUEUE and returns used buffers to the OUT-QUEUE. The task 
processes the buffers from the OUT-QUEUE and returns these 
buffers to the IN-QUEUE for reuse by the driver. A special 
gapless format SVCl parameter block must be used for gapless I/O 
operations. Buffers used within a single gapless I/O operation 
must be equal in length, with the possible exception of the last 
buffer used. 


5.11 DISK STORAGE 


Perkin-Elmer disk devices support variable length records. 
During input, a current sector pointer is maintained. Ona 
sequential read, data is read into the user buffer from the disk, 
starting at the current sector, until the buffer is full. If an 
attempt is made to read beyond the end of the disk, end of medium 
(EOM) status is returned. On a random read request, data is read 
from the disk starting at the sector specified by the random 
sector address passed with the request, until the buffer is full. 
If an attempt is made to read beyond the end of the disk, EOM 
status is returned with data transferred. ASCII, binary and 
image requests are identically treated. 


During output, data is written from the user buffer to the disk, 
starting at the current sector (for sequential writes) or at the 
specified sector (for random writes), until the buffer is empty. 
Attempts to write past the end of the disk cause EOM status to be 
returned. In this case, no data is transferred. 


Errors on data transfers cause the operation to be retried 
several times before returning error status. 
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All data transfers start on a sector boundary, but can end on any 
byte of a sector. If the size of the user buffer is less than 
the record size of an indexed file to which it is written, the 
remaining bytes will be filled with blanks for ASCII writes or 
binary zeros for binary writes. If a record written toa 
contiguous, extendable contiguous or nonbuffered indexed file is 
less than the file's record length, the last byte or two bytes 
are propagated through the remaining unfilled bytes of the last 
256-byte sector of the record. 


Only executive tasks (e-tasks), privileged user tasks (u-tasks), 
and diagnostic tasks (d-tasks), linked with bare disk privileges 
(OPTION DISC), can access a bare disk. Nonprivileged u-tasks and 
d-tasks access the disk via the contiguous, extendable 
contiguous, nonbuffered indexed or indexed file handlers. 


5.12 FLOPPY DISK 


Variable length records are supported by Perkin-Elmer floppy 
disks. During input, a current sector pointer is maintained. On 
a sequential read, data is read from the disk starting at the 
current sector into the user buffer until the buffer is full. On 
a random request, the data is read from the disk starting at the 
sector specified by the random sector address passed with the 
request, until the buffer is full. If an attempt is made to read 
beyond the end of disk, EOM status is returned with data 
transferred. ASCII, binary and image requests are identically 
treated. 


During output, data is written from the user buffer to the disk, 
starting at the current sector pointer (for sequential writes) or 
at the specified sector (for random writes), until the buffer is 
empty. If an attempt is made to write beyond the end of the 
disk, EOM status is returned with no data transferred. ASCII, 
binary and image requests are identically treated. 


Errors on data transfers cause the operation to be retried ten 
times before returning error status. 


All data transfers start on a logical 256-byte sector boundary 
(two physical sectors on the floppy). Transfer can end on any 
byte of a sector. 


The floppy disk driver is designed for use by the file manager. 
A user program cannot access a bare disk unless it is an e-task, 
privileged u-task or d-task linked with bare disk privileges 
(OPTION DISC). For nonprivileged u-tasks and d-tasks, the disk 
is accessed by the contiguous, extendable contiguous, nonbuffered 
indexed or indexed file handlers. 
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5.13 VIDEO DISPLAY UNIT (VDU) TERMINALS 


Variable length records are supported by all Perkin-Elmer VDU 
terminals. 


During non-VFC read ASCII operations, data read is masked to 
7-bit ASCII. Data is read until the buffer is full or a CR is 
encountered, whichever occurs first. Upon termination, a CR/LF 
sequence is sent to the screen. 


During non-VFC write ASCII operations, the buffer is scanned to 
eliminate trailing blanks. Data is then sent to the VDU until 
the buffer is exhausted, the last nonblank character has been 
processed, or until a CR is found in the data stream. An LF is 
automatically appended to the detected CR; if no CR is detected, 
an LF/CR sequence is sent to the terminal. 


During non-VFC image I/O, none of the above formatting actions 
occur. The amount of data requested is output or read in without 
masking to 7-bit ASCII, eliminating trailing blanks, checking for 
control characters, or detecting or appending CRs or LFs. On 
image read, however, an ASCII CR is detected as an end of line 
sentinel. 


For information on I/O operations with VFC, see Section 5.2. See 
the OS/32 Operator Reference Manual for an explanation of the 
function control keys available on Perkin-Elmer VDU terminals. 


5.14 8-LINE INTERRUPT MODULE 


Interrupt simulation (SINT) is the only attribute supported by 
the Perkin-Elmer 8-line interrupt module. The module provides 
the processor with eight interrupt lines from external equipment 
and acknowledges interrupts on a priority basis. Any line can be 
selectively enabled Or disabled. Several lines can be 
concurrently enabled. An interrupt does not transfer any data, 
nor is any status given. 


5.15 DIGITAL MULTIPLEXOR (MUX) 


ASCII operations are not supported by the Perkin-Elmer digital 
MUX. During input, the second byte of the random address field 
contains the segment and point number to be read. Data is read 
from the point specified until the buffer specified by the 
starting and ending address is full. 


During output, the second byte of the random address’ field 
contains the segment and point number to be written to. Data is 
written until the buffer specified by the starting and ending 
address is exhausted. 
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5.16 CONVERSION EQUIPMENT 


The analog conversion equipment, used with Perkin-Elmer 32-bit 
computers, cannot be programmed in the device-independent manner 
of other peripheral devices. The chassis, channel and card 
addresses, and data values are directly passed to the real-time 
analog system controller as the 16-bit words that are obtained 
from the user. 


During input, the random address field of the SVCl parameter 
block contains the starting address of a table containing 
analog-to-digital converter addresses (chassis address, channel 
address and card address). The user buffer, which the start and 
end addresses of the parameter block determine, is loaded with 
the digitized data obtained from these analog-to-digital 
converters. 


The table length containing the converter addresses is equal to 
the length of the buffer. It is the user's responsibility to 
provide valid addresses. Since the analog input system mode of 
the controller is used for READ, if a nonexistent chassis is 
addressed, zero data is stored and no other indication is given. 


During output, the user buffer is assumed to contain sequential 
pairs of alternating digital-to-analog converter addresses and 
the corresponding data to be converted; i.e., ADD1, DATAl1, ADD2, 
DATA2,...ADDn, DATAn. The address and data are directly passed 
to the real-time analog system controller. 


The control output mode of the controller is used for write 
operations. If a nonexistent chassis is addressed, the status is 
set to X'88' and the remainder of the I/O is aborted. 


Each write sequence to any converter must consist of two 
halfwords. One halfword specifies the adapter to do the 
conversion; the other halfword contains the data to be converted. 
A buffer must be a multiple of two halfwords in length; 
otherwise, any attempt to do a write results in a memory fault. 


For read and write operations, ASCII/binary and image/format 
requests are identical. 


5.17 ANALOG INPUT CONTROLLER (AIC) 


Variable record lengths are supported by the Perkin-Elmer AIC. 
ASCI[ operations are not supported. Command functions are 
ignored. 


The random address field of the SVCl parameter block contains the 
gain and address of the first channel to be sampled. The format 
is shown in Figure 5-1. Dividing the length of the user buffer 
(END-START+1) by two determines the number of channels to sample. 
The digitized data is sequentially stored in the user buffer, one 
halfword per channel. . 
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Figure 5-1: Random Field Format 


The driver accepts only random calls, meaning that the first 
address is selected at random and that further addresses are 
sequential (in the same call). The start address must be on an 
even address boundary and the end address must be on an odd 
address boundary, since the AIC is a halfword device. This 
complies with the Instrument Society of America (ISA) definition 
of sequential analog input. 


5.18 ANALOG OUTPUT CONTROLLER (AOC) 


All command functions are ignored by the Perkin-Elmer AOC. One 
halfword of data is obtained from the user buffer in the format 
specified in Figure 5-2 and written to the device for conversion. 
This procedure is repeated until all halfwords in the user buffer 
are output. Dividing the length of the user buffer (END-START+1) 
by two computes the number of halfwords to be output. 


Figure 5-2 Analog Output Data Format 


Binary image is treated identically to binary formatted; the 
image bit is ignored. The sequential/random bit is also ignored. 
The start address must be aligned on an even boundary, whereas 
the end address must be on an odd boundary because the AOC is a 
halfword device. 
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5.19 DIGITAL INPUT/OUTPUT (DIO) CONTROLLER 


All command functions are ignored by the Perkin-Elmer DIO 
controller. The number of transfers is computed using the start 
and end address’ fields: (END-START+1)/2. Resetting the 
sequential/random bit in the function code field causes transfers 
to occur sequentially without interruption. This is a 
nonhandshaking transfer mode. In the handshaking transfer mode, 
the sequential/random bit is set, and each transfer occurs only 
after the internal strobe line is pulsed. A time-out rate for 
each transfer is set at a constant of ‘four seconds. 


During a binary read operation, one halfword of data is 
transferred to the user buffer whose starting address is stored 
in the SVCl parameter. block. Each halfword of data from 
subsequent binary read operations is stored sequentially in the 
user buffer. : 


For binary write operations, the buffer starting address in the 
SVCl parameter block points to a buffer (Kl) consisting of image 
halfwords for transfer to an output device. The random address 
field of the SVCl parameter block points to another buffer (K2) 
of halfwords designating masks, each of which defines the 
corresponding bit position of the halfwords in Kl to be changed. 


The length of K2 must be the same as that of Kl. A bit set in K2 
indicates that the digital output is changed to the state defined 
by the corresponding bit position in Kl. The following logical 
expression computes the halfwords transferred to the digital 
output card: 


(KleK2) + (K2eR) 


Where: 
e means logical AND. 
+ means logical OR. 
K2 means one's complement of K2. 
R is the last known content of the output 


register. 


Binary image is treated identically to binary formatted; the 
drive ignores the formatted/image bit of the SVCl function code. 
Both handshaking and nonhandshaking transfer modes are supported. 
The start and random addresses of the user buffer must be aligned 
to even boundaries, whereas the end address must be aligned to an 
odd boundary because the power input/output (PIO) controller is 
a halfword device. 
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5.20 ETHERNET DATA LINK CONTROLLER (EDLC) 

Ethernet is a multi-access, packet-switched communication system 
for carrying data among locally distributed computing systems. 
The EDLC provides processor-to-processor serial communication 
clocked at 10Mb per second over a common coaxial cable up to 500 
meters long. The Ethernet specifications will support over 100 
processor interfaces in a variety of configurations. 


The following publications provide more information: 


0S/32 Network Drivers Programming Reference Manual 


Perkin-Elmer Series 3200 Ethernet Controller Installation, 
Operation and Programming Manual 


Perkin-Elmer Series 3200 Ethernet Interface Test Program 
Description 


Interlan NMLOA Ethernet Protocol Module Users Manual 


Ethernet Network Specification Document 
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APPENDIX A 
038/32-SUPPORTED INPUT/OUTPUT (I/0) DEVICES 
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DEVICE 


Intertape 
600/800 bpi dual 
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Carousel 300 with 
bpi) 


electronic format 


controls 
Paper tape reader/ 


punch 
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Letter quality 
printer 
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printer 
Thermal page 


Perkin-Elmer 
printer 
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TYPE 


45 ips, 


DEVICE 
800/1600 bpi 


9-track, 


agnetic 
ape 


Continued) 


45 ips, 


9-track, 
800 bpi 


-5Mb moving head 


1.5Mb head per 
track (HPT) disk 


removable 


isk, 


NT 


.5Mb moving head 
fixed 


isk, 


NT 


OMb moving head 
isk (SMb fixed, 


emovable) 


be) 


OMb moving head 
removable 


isk, 


fixed 


50Mb CDDSO, 
portion (25Mb) 


remov- 


ble portion 


25Mb) 


OMb CDD50, 


Mm Oo~ 


fixed 


67Mb disk, 


7JMb disk, 
emovable 


fixed 


160Mb disk, 


emovable 


56Mb disk, 
256Mb disk, 


fixed 


fixed 


675Mb disk, 
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TYPE H DEVICE IDI T{ISiINITiD:PiTiT} 


| 

i 

i 

|} Conversion | Real-time analog a fat a je a 

} equipment } system with | 

j { internal clock | 

H Be ea ye pe mapa eee a Bee en ee git ee ee 

i | Real-time analog 

i system with user- | 

H | supplied external | 

| | clock | 

| ee ee ee ee 
Analog 1/0 {| Analog input 
controller {| controller (AIC) 

Ves iat raha Sa he ee Sr yh i pap ai ee tata wil Ba ass a 
| Analog output 1 | 
{| controller (AOC) 1 $x 


} Digital I/O | Digital I/O and | 
; controller {| analog output | 
{ | system | 


* CLI - Current loop interface 
A CLCM ~- Current loop communications multiplexor 


$ RS-232C 
ATTRIBUTES 

RD Read 

WRT Write 

Ts Test and Set 
BIN Binary 

WAT Wait 


RND Random 

FLP File Position 
INT Interactive 
HLT Halt I/0 
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APPENDIX B 
SUPPORTED VERTICAL FORMS CONTROL (VFC) CHARACTER SET 


i | OPERATIONS AFFECTING 
! ' 
\ 1 


' 
{ 
i HEX 


t 

1 

CHAR LINE SPACING H 

j HS SS SSS SSS Se SSS cee eee eee eee! 
} 09 | HT | Horizontal tab : 
i OB {| VT {| Set vertical tabs H 
H i (EVFU, no print) i 
; 20 |} b | 1 line b/print i 
i 2B} + {| No line advance H 
; 2D { - {| 3 lines b/print H 
; 30 } O | 2 lines b/print H 
; 31 | 1 {| Top of form b/print H 
i; 32 4} 2 {| Select VFU-2 b/print |} 
; 33 4 3 | Select VFU-3 b/print |} 
} 34 | 4 | Select VFU-4 b/print jj; 
i 35 { 5 {| Select VFU-5 b/print | 
i 36 | 6 {| Select VFU-6 b/print | 
1 37 4 7 | Select VFU-7 b/print | 
i 38 | 8 | Select VFU-8 b/print | 
1} 39 | 9 | Select VFU-9 b/print | 
i 41 | A | Select VFU-10 b/print | 
+ 42° | B {| Select VFU-11 b/print } 
| 43 | C {| Select VFU-12 b/print ; 
; 45) 4} E {| 1 line a/print H 
; 46 } F ;} No line advance i 
i 47) | G ; 3 lines a/print H 
; 48 3 H {| 2 lines a/print } 
1 49 4} I { Top of form a/print i 
| 4A | J ;{ Select VFU-2 a/print | 
i; 4B sf K {| Select VFU-3 a/print | 
1 4C | IL {| Select VFU-4 a/print | 
; 4D } M ; Select VFU-5 a/print | 
i 4E | N { Select VFU-6 a/print | 
1 4F | O {| Select VFU-7 a/print |} 
i 50 4} P { Select VFU-8 a/print } 
i 51 | P ; Select VFU-9 a/print } 
i 52 | R {| Select VFU-10 a/print } 
i 53 ] S {| Select VFU-11 a/print | 
i; 54 | T | Select VFU-12 a/print | 
; 60 | ‘ {| No line advance i 
; 61 | a { 1 line b/print H 
i 62 | b j; 2 lines b/print H 
; 63 | c ; 3 lines b/print { 
1; 64 | qd ; 4 lines b/print { 
i; 65) | e {; 5 lines b/print H 
i; 66 | f {| 6 lines b/print i 
; 67 4} g { 7 lines b/print | 
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OPERATIONS AFFECTING 


> 


twee NEM ESC SCTMOROADODS eR ST |b 


DEL 


23 Boe wet oe te SS lie ee eles eae eS eS Se eee SS Se Se SSS SS SS See SS Sr ae we ee ee ee oe oe 


uss ese ea Se SSS SS SSS STS TS SS 


LINE 


SPACING 


8 lines b/print 
9 lines b/print 


lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
Lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
Lines 
Lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 


b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/pr int 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/pr int 
b/print 
b/pr int 
b/print 
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mee ew ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee we we ee me ee ee 


OPERATIONS AFFECTING 
LINE SPACING 


i 
{ 
1 
1 
t 
' 
i] 
{ 
' 
1 
1 
i) 
' 
i) 
i 
‘ 
1 
t 
{ 
4 
1 
1 
t 
' 
1 
' 
i) 
4 
' 
] 
i 
1 
' 
{ 
1 
1 
J 
' 
! 
' 
' 
i} 
' 
§ 
1 
' 
i) 
' 
' 
‘ 
1 
{ 
1 
1 
' 
t 
1 
1 
4 
1 
| 
! 
1 
1 
! 
f 
1 
t 
t 
§ 
i 
' 
' 
i 
i 
4 
4 
4 
4 
t 
4 
t 
q 
4 
i] 
q 
1 
( 
' 
1 
1 
1 
! 
t 
{ 
4 
1 
1 
1 
' 
' 
1 
i] 
4 


60 


lines 
lines 
Lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
Lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
line 


b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/pr int 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
b/print 
space 


line a/print 


lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
lines 
Lines 
lines 
lines 
lines 
lines 
Lines 
Lines 
lines 
Lines 
lines 
Lines 
lines 
lines 
Lines 


a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/print 
a/pr int 
a/print 
a/print 
a/print 


OPERATIONS AFFECTING 


HEX 


Ee ES ES Et 


CHAR 


wee we mame me ee ee ee ee ee ee ee ee ee ee ee ne se ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 
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A 


Account Reporting Utility 
Accounting transaction file. 
See ATF. 
AIC 
random field format 
supported record lengths 
Analog conversion equipment. 
See conversion equipment. 
Analog input controller. 
See AIC. 


INDEX 


Card reader/punch devices 
(Continued) 
Hollerith code 
translation 
image operations 
supported record lengths 
Central processing unit. 
See CPU. 
Circular list 
Command processor subsystem 
Command substitution system. 
See CSS. 


Analog output controller. Commands 


See AOC. DISPLAY accounting 
Aoc DISPLAY ERRORS 
address alignment 5-14 Link OPTION 
binary image 5-14 MEMORY 
data format 5-14 OPTION APMAPPING 
APU OPTION LPU 
execution queue 1-8 OPTION NLPU 
fault handling 3-19 QUEUE 
idle queue 1-8 SET PRIORITY 
internal task control 3-18 SET SLICE 
memory conflicts 3-21 SLICE 
Model 3200MPS System 1-2 Computation-intensive task 
monitor task 3-12 Console driver 


monitoring task execution 3-10 Console monitor subsystem 
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operating states 3-3 Conversion equipment 
private queue 1-8 dev ice-dependent. 
shared queue 1-8 
status condition 3-11 write sequence 
status signal 3-10 CPU 
SVC handling 3-19 Model 3200MPS System 
task queue order 3-8 ready queue 
transferring a task 3-17 
trap-generating devices 3-13 receive queue 
verifying task transfer 3-19 roll-in queue 
APU-only queues 3-4 
ATF 1-10 css 
Auxiliary processing unit. 
See APU. 
D 
B D-tasks 
Basic data communications Data Collection Facility 
subsystem Data management system. See 
device-dependent 1/0 1-15 DMS /32. 
device-independent 1/0 1-15 Data structures 
protocols 1-15 Diagnostic tasks. See 
Bidirectional input/output d-tasks. 
control. See BIOC. Digital input/output 
BIOC driver controller. See DIO. 
horizontal tabbing 5-2 Digital MUX 
Buffer access ; 3-21 supported operations 
DIO controller 
address alignment 
c binary operations 
transfer modes 
Card reader/punch devices Disk storage 
ASCII operations 5-3 i ASCII operations 
binary operations 5-3 
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Disk storage (Continued) 


| 
bare disk 5-11 | 
current sector pointer 5-10 | I/0 
files 5-11 | attributes A-l 
random read request 5-10 |} functions 5-1 
random writes 5-10 } intensive task 3-2 
sequential writes 5-10 | operations 1-13 
supported record lengths 5-10 |} subsystem 1-13 
DISPLAY accounting command 1-11 | supported characters 5-1 
DISPLAY ERRORS command 1-14 | ICONT macro 4-13 
DMS /32 1-2 | 4-26 
| ICREATE macro 4-8 
i 4-16 
E | Idle queue: 1-8 
{ IERRTST macro 4-14 
E-tasks 2-1 | 4-32 
characteristics 2-2 | IGET macro 4-11 
data structures 2-3 H 4-23 
programming 2-2 { Input/output. See I/O. 
EDLC 5-16 } Instrument Society of 
Error recording H America. See ISA. 
file 1-14 } Integrated transaction 
log buffer 1-14 | controller. See ITC. 
log hardware : 1-14 | Intercept macros 
subsystem 1-14 | $RDB 4-34 
Error Reporting Utility 1-14 } error codes 4-13 
Ethernet data link H ICONT 4-26 
controller. See EDLC. H ICREATE 4-16 
Execution queue 1-8 i IERRTST 4-32 
Executive tasks. See { IGET 4-23 
e-tasks. | I PROCEED 4-27 
H IPUT 4-24 
I I REMOVE 4-21 
F i TROLL 4-28 
i ITERM 4-29 
Fault handling H ITRAP 4-30 
File management H syntax 4-15 
subsystem | Intercept path 4-4 
support services | control level 4-11 
Files H end of task operation 4-11 
Floating point subsystem H example 4-12 
Floppy disk i full control 4-11 
bare disk 5-11 | identifier 4-7 
current sector pointer 5-11 | Monitor control 4-11 
driver 5-11 | removal of 4-13 
errors 5-11 } Internal interrupt subsystem 1-17 
random read request 5-11 | Interrupt simulation. See 
random writes 5-11 | SINT. 
sequential writes 5-11 j{ . Interval timer 3-15 
supported record lengths 5-11 {| IPROCEED macro 4-11 
| 4-27 
{| IPUT macro 4-11 
G H 4-24 
| IREMOVE macro 4-13 
Gapless I/O operation H 4-21 
magnetic tape 5-10 {| IROLL macro 4-11 
\ 4-28 
| ISA 5-14 
H i Itc 1-2 
| ITERM macro 4-13 
Hardware-echo 5-2 ; 4-29 
Horizontal tabs 5-2 | ITRAP macro 4-11 
i 4-30 
{ 
i 
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J,K 


Job accounting subsystem 
Data Collection Facility 


L 


LFC 

LIB 

Line frequency clock. See 

LFC. 

Line printers 
ASCII operations 
horizontal tabbing 
supported record lengths 

Link OPTION command 

LLE 

Load-leveling executive: 

See LLE. 

Load power fail monitor. 

See LPFM. 

Loader and segmentation 

subsystem 

Loader information block. 

See LIB. 

Local memory 

Logical processing unit. 

See LPU. 


MEMORY command 
Memory conflicts 
buffer access 
example of preventing 
system deadlock 
test and set 
Memory diagnostics 
MEMORY command 
subsystem 
Memory error recording. See 
error recording. 
Memory map 
Model 3200MPS System 
additional information 
sources 
advantages 
configuration 
designing tasks 
interrupt handling 
memory conflicts 
monitoring task execution 
overview 
performance advantage 
problem solving 
programming 
queue assignments 
queue priority 
assignments 
queues 


1-14 


3-21 
3-21 
3-21 
3-21 
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3 
3 
Logical processor mapping real-time performance 3-22 
table. See LPMT. rollable tasks 1-10 
LPFM 3-4 task assignments 3- 
LPMT 1-2 task execution order 3- 
LPU 1-2 task queue order 3- 
assigning tasks 3-7 task scheduling 1- 
definition 3-6 verifying task transfer 3-19 
directed tasks 3-7 Monitor program. See 
mapping 3-6 monitor task. 
OPTION LPU command 3-7 Monitor task 
OPTION NLPU command 3-7 example 3-12 
interval timer 3-15 
preemption mechanism 3-15 
M,N task transfer 3-17 
MTM 1-2 
Macro libraries 2-3 Multi-terminal monitor. See 
MTM 2-7 MTM. 
0S /32 2-4 Multiplexor. See digital 
Magnetic tape MUX. 
data transfer 5-10 Multiprocessing system. See 
gapless I/O 5-10 Model 3200MPS System. 
parity error 5-9 
read operation 5-10 
record gap 5-9 Oo 
recording density 5-9 
retry value 5-9 Operating states 
standard 1/0 5-9 APU 3-3 
supported record lengths 5-9 APU-only queue 3-4 
tape erasure 5-9 OPTION APMAPPING command 3-4 
write operat.ion 5-10 OPTION LPU command 3-7 
Memory OPTION NLPU command 3-7 
local 1-11 0S /32 
management subsystem | 1-11 Account Reporting Utility 1-10 
shared 1-11 basic data communications 1-15 
system 1-11 command processor 1-16 
console monitor 1-16 
Data Collection Facility 1-10 
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OS/32 (Continued) Queues (Continued) 


data structures 2-3 priority assignments 3-9 
error recording 1-14 priority-ordered 1-9 
file management 1-13 private 1-8 
floating point 1-18 ready 1-6 
I/O devices 5-1 receive 1-6 
A-1 roll-in 1-6 

1/O operations 1-13 shared 1-8 
interrupt servicing 1-17 task trap-handling 3-12 
job accounting 1-10 timer management 1-12 
linkage editor 1-1 types 1-8 
loader and segmentation 1-14 
macro libraries 2-3 
memory diagnostics 1-14 R 
memory management 1-11 
multiprocessing support 1-2 RDB 
overview 1-1 buffers 4-4 
roll function 1-1 circular list 4-6 
software support summary 1-4 fields 4-4 
subsystems 1-3 $RDB macro 4-34 
supported I/O devices 5-1 Ready queue 1-6 
system initialization 1-17 1-8 
task management 1-5 Real-time performance 
timer management 1-12 timer macros 3-22 
user SVC 1-18 Real-time support module. 
V™ 1-1 See RTSM. 

Receive queue 1-8 

Reliance 1-2 

P Relocation/protection 
hardware 1-15 


Paper tape equipment 

ASCII operations 

binary operations 

image operations 

supported record lengths 
PIc 
Precision interval clock. 
See PIC. 
Priority. See task priority 


Request descriptor block. 
See RDB. 

Roll function 

Roll-in queue 


Rollable tasks 

Model 3200MPS System 
RTSM 
Run priority 


levels. adjustment 
Private queue 1-8 
Privileged instructions 2-1 
Privileged tasks s 
d-tasks 2-1 
e-tasks 2-1 ScL 1-12 
Link OPTION command 2-1 Segment control list. See 
types 2-1 ScL. 
u-taska 2-1 Segments 
Pseudo aevice impure 1-15 
definition of 4-8 pure 1-15 
generic naming 4-9 SET PRIORITY command 1-7 
SET SLICE command 1-7 
Shared memory 1-11 
Q Shared queue 1-8 
SINT 5-12 
QUEUE command 3-4 SLICE command 1-7 
Queues Software-echo §-2 
altering priority SPT 2-2 
assignments 3-9 Standard 1/0 
APU-only 3-2 magnetic tape 5-9 
3-4 Status signal 
CPU-ready 3-2 format 3-10 
execution 1-8 Subsystems. See 08/32. 
idle 1-8 Supervisor call. See SVC. 
Model 3200MPS System 1-8 vupervisor monitor 3-2 
no-priority 1-9 
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svc Task (Continued) 
creating intercept paths - priority levels 
handling -19 privileged 


recipient existent mode 
recipient nonexistent 
mode 

Svc interception 
caller mode 


processing 

processor control 

pure 

self-directed transfer 
transfer from APU to CPU 


i 


error handling -13 transfer to APU 

functional summary -10 verifying transfer 

macros = Task control block. See TCB. 
-15 Task event trap 

operation = handler 


pseudo device creation 
sample programs 

syntax 

task preparation 


register saved 

Task management 
handling task traps 
Model 3200MPS System 
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termination of -13 scheduling 
svc1l subsystem 
interception = Task priority levels 
-10 dispatch 
svcl13 - max imum 
= run 
-13 task 
control sequence ~16 Task trap service 
example ~15 TCB 
SVC2 code 7 Teletype. See TTY. 
interception 4-2 Terminals. See VDU 
4-10 terminals. 
svc3 Test and set 
interception 4-2 Time-slicing 
4-10 dynamic 
SVC6 SET PRIORITY command 
example 3-7 SET SLICE command 
interception 4-2 SLICE command 
4-10 system 
internal task transfer 3-18 Timer macros 
task transfer 3-17 CRT IMERS 
SvCc7 example 
interception 4-2 GET IME 
4-10 measure performance 
System initialization READTCNT 
subsystem 1-17 RESET IME 
System memory 1-11 STOPTIME 
System pointer table. See STRT IME 


SPT. Timer management subsystem 


Timer queues 
communications device 
time-out 
device time-out 
interval timer 


T 


Tape cassette 


ASCII operations 5-8 servicing routines 
binary operations 5-8 time of day 
image operations 5-8 Trap generating devices 
parity errors 5-8 connecting 
supported record lengths 5-8 TTY keyboard/pr inter 

Task ASCII operations 
aynamic scheduling 1-6 supported record lengths 
example 3-17 TTY reader/punch 
image 1-15 ASCII operations 
impure 1-15 binary operations 
loading 1-14 image operations 
modes 1-13 supported record lengths 
order of execution 3-8 
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U-tasks 


privileged 
UCLOCK 
Universal clock. See UCLOCK. 
User SVC subsystem 
User tasks. See u-tasks. 


ViW,X,Y,Z 


VDU terminals 
ASCII operations 
image I/O 
Vertical forms control. See 
VFC. 
VFC 
character set 
theory of operation 
Video display unit 
terminals. See VDU. 
Virtual task manager. See 
VIM. 
VT™M 


8-line interrupt module 
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